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Preface 


This manual describes how to install, configure, and troubleshoot the 
Token Ri ng board and software products on PCI, M odel 712, H P 9000 
EISA, and Series 800 HP-PB systems. 

The manual isorganized according to the sections listed below. Where 
appropriate, some sections are further divided into various sub-sections. 
If you are using PCI Token Ring, you can skip sections titled Model 712, 
HP 9000 EISA, or Series 800 HP-PB. Non-PCI users can skip sections 
titled PCI. 


Chapter 1 
Chapter 2 
Chapter 3 

Chapter 4 

Appendix A 
Appendix B 
Appendix C 
Glossary 


"I nstalling Token Ring" describes how to install Token 
Ring software and hardware. 

"Configuring Token Ring" describes the steps to 
configure Token Ring software. 

'Token Ring Resources" provides references to other 
useful tools for installing, configuring, and maintaining 
H P Token Ring software. 

'Troubleshooting Token Ring" provides flowcharts to 
help diagnose Token Ring software and hardware 
problems. 

'Token Ring I nterface Card Statistics" defines the 
terms listed in the lanadmin(lM) command display. 

'Token Ring Network Map" provides an exampleToken 
Ring network map and worksheet. 

'Token Ring Hardware Path" provides detailed 
information about the hardware path on all systems. 

"Glossary" provides definitions of Token Ring terms 
used in this manual. 
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Information About the PCI Token Ring Board 

Benefits and Features 

On HP-UX 10.20 systems, PCI Token Ring software supports the 
following: 

• 100/16/4 M b/s hardware (A5783A) on al I H P 9000 workstations with a 
PCI bus. 

On HP-UX 11.x systems, PCI Token Ring software supports the 
following: 

• 16/4 M b/s hardware (A4930A) on V-Class servers. 

• 100/16/4 Mb/s hardware (A5783A) on all HP 9000 workstations and 
servers with a PCI bus. 

Hardware is customer-installable on all platforms except V-Class and 
Superdome. Refer to the hardware installation sections in Chapter 1 of 
this manual. 

Notes about New Hardware and Software 

A new PCI Token Ring adapter (A5783A) was introduced on April 1, 
1999. It replaced the previous adapter (A4930A). The A5783A adapter is 
supported on all HP 9000 servers and workstations with a PCI bus. The 
A4930A was supported on V-Class only, and was removed from the CPL 
on J une 1, 1999. 

The main differences between the A5783A and theA4930A are: 

• H ardware and correspond! ng software have the same product 
numbers. 

• Support for all PCI -based servers and workstations. 

• Support for speeds of 4 or 16 M b/s on IBM and Cisco M AU/Switches, 
or 100 M b/s on Olicom/M adge switches. 

• Customer-configurable on all platforms. 

• Customer-installable on all platforms except V-Class and Superdome. 

• The DB9/RJ 45 Loopback connector is not supported. 

• The maximum number of active PCI Token Ring cards supported on 
Superdome is 10 on 16-way, 20 on 32-way, and 40 on 64-way. On 
V-Class, the maximum number is 4. For all other platforms, the 
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maximum number is equal to the number of slots in the system. 

I n the PCI sections of this document, the phrase "the software 
product(s)" is used to refer to one or more of the following PCI Token 
Ring software product numbers: 

. j 1644AA 

• A4930A 

• A5783A 

Note that for 111, the software bundle tags were changed to 
TokenRing-00. 

If theA4930A hardware is present, theA4930A or TokenRing-00 
software bundleshould be installed. 

If theA5783A hardware is present, theA5783A or TokenRing-00 
software bundleshould be installed. 

If the system has both cards, then both software bundles should be 
install^. 

The continued use of J 1644AA is discouraged. UseA4930A or A5783A 
software in its place. 
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Installing Token Ring 


This chapter describes the prcxiedures to load Token Ring hardware and 
software onto your system. 


Chapter 1 
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Installing Token Ring 

Overview of Token Ring instaiiation 


Overview of Token Ring Installation 

Installation of Token Ring includes: 

Step 1: CheckingToken Ring installation prerequisites. 

Step 2: I nstalling Token Ring hardware. 

Step 3: LoadingToken Ring software. 

Step 4: Setting a Card's Configuration by following the procedures in 
Chapter 2, "ConfiguringToken Ring." 


NOTE Prior to installingToken Ring, HP recommends that you create a 

network map or update the existing map of your Token Ring network. 
Refer to Appendix B, 'Token Ring Network Map," for an example Token 
Ring network map. 
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Installing Token Ring 

Step 1: Checking Token Ring instaiiation Prerequisites 


Step 1: Checking Token Ring Installation 
Prerequisites 

Model 712, H P 9000 EISA, or Series 800 HP-PB 
Systems 

Please note that the EISA bus version of Token Ring has been obsoleted 
as of J uly 1999.1 nstallation information about this product is included 
here for the sake of completeness. 

1. Check that the / usr/ bin, / usr/ sbin and / sbin directories are in your 
PATH using the command: 

echo $PATH 

2. Check that the operating system has been upgraded to 10.x or 11.x 
software, as appropriate. 

To obtain this information, execute the command: 

uname -a 

3. Verify that you have a lobe cable to connect your Token Ring card to 
your T runk Access Unit (TAU). (The cable and TAU do not come with 
the H P Token Ring product.) 

4. Model 712: Verify that the slot for the Model 712 card in the system 
backplane is empty. 

HP 9000EISA: Verify that the system backplane contains an EISA 
system interface. If you have a Series 715/33 or 720 model, be sure 
that you ordered and installed the EISA system interface; for all 
other H P 9000 EISA, the El SA system interface is preinstalled. The 
EISA interface should also contain an available empty EISA slot for 
theToken Ring card. 

Series 800 HP-PB: Verify that the system backplane contains an 
available empty H P-PB slot for theToken Ring card. 

5. Verify that you have an I P/I nternet address, alias, and subnet mask 
(optional) for your new Token Ring card. After you have obtained this 
information, fill out the Network Card Configuration Worksheet in 
your Token Ring Quick I nstallation Guide 


Chapter 1 
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Installing Token Ring 

Step 1: Checking Token Ring instaiiation Prerequisites 


Table 1-1 


A summary of the major characteristics of each Token Ring card is 
shown in the table below. 


Token Ring Card Summary 


Category 

EISA 

(discontinu 

ed) 

M712 

HP-PB 

PCI 

Bus 

EISA 

HP GSC 

HP-PB 

PCI 

STP 

Connection 

DB-9 

DB-9 

DB-9 

DB-9 

UTP 

Connection 

RJ 45 

RJ 45 with 
Media 

Filter 

(Provided) 

RJ 45 with 
Media 

Filter 

RJ 45 with 
Media 

Filter 

Speed 

16M bps 
UTP/STP 
4Mbps 
UTP/STP 

16M bps 
UTP/STP 

4M bps 
UTP/STP 

16M bps 

STP 

4M bps 
STU/UTP 

lOOM bps 

16M bps 
4Mbps 

Default 

Speed 

No speed 

OM bps 

4M bps 

must config 

Configure 

Speed 

eisa_config 

SAM or 
lanadmin 

J umper on 
card 

lanadmin 

-or- 

config file 

-or- 

SAM 

LED on 

Card 

No 

No 

Yes 

Yes 

Card 

Self-Test 

Yes 

Yes 

Yes 

Yes 


6. Verify that you have super-user status. 

7. Model 712: Verify that you have the HP A4011A/ B Token Ring 
Adapter Installation and Configuration manual. 

HP 9000 EISA: Verify that you have the El SA Token Ring Ndiwork 
Adapter manual. 
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Installing Token Ring 

Step 1: Checking Token Ring instaiiation Prerequisites 


Series 800 HP-PB: Verify that you have the HP-PB Token Ring 
Network Adapter manual. 

Prior to loading theToken Ring product onto your system, check that you 
have met the following hardware and software prerequisites: 

PCI Systems 

You can install PCI Token Ring from your application media during a 
normal system operation where the following requirements have been 
met. 

Hardware Requirements 

On HP-UX 10.20 systems, A5783A is supported on all HP 9000 
workstations with the PCI bus. 

On HP-UX 11.x systems, A5783A is supported on all HP 9000 servers 
and workstations with the PCI bus. A4930A is supported on V-Class 
servers only. 

Although V-Class and Superdome systems have a PCI bus, they do not 
permit user installations. If you need to install PCI Token Ring on these 
machines, please contact Hewlett-Packard for service. 

OS Platform and Version Compatibility 

HP-UX CORE B.10.20or B.11.00or later. 

Software Requirements 

The system must have standard H P-UX 10.20 or 11.x core products, 
including Streams and LAN/9000 software, installed on it. 

Please refer to the Release Notes document for required patch 
information. 

The major characteristics of the PCI Token Ring card are listed in Table 
1 - 1 . 


Other Requirements 

The system is already booted up for operation. 

Single-user state is not required. 

No additional reboot is required after the installation as the PCI Token 
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Installing Token Ring 

Step 1: Checking Token Ring instaiiation Prerequisites 


Ring software/hardware installation procedure causes a system reboot. 

We recommended that you reboot after configuring 

/etc/rc.config.d/pcitrconf, but yoU Can execute 
/sbin/rc2. d/s3i5pcitr start to prevent a reboot. 

After reboot, check what (i) string on the kernel. Execute: 

what /stand/vmunix | grep Token 

You should see the following on HP-UX 10.20 systems: 

A5783A/J1644AA HP PCI Token Ring <version> (<release>) 
<date> 

You should see the following on HP-UX 11.x systems: 

A5783A/A4930A/J1644AA HP PCI Token Ring <version> 
(<release>) <date> 

Please refer to the Release Notes document for the current values of 
"<version>", "<release>" and "<date>". 

Disc Space Required for Installation 

This product requires 700 K bytes in addition to the current disc space 
being utilized. 
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Installing Token Ring 

Step 2: Installing Token Ring Hardware 


Step 2: Installing Token Ring Hardware 

Follow the steps below to install theToken Ring board. 

Model 712, H P 9000 EISA, or Series 800 HP-PB 
Systems 

1. At the HP-UX prompt, execute the following command and wait for 
the system to respond with the message "H alted, you may now cycle 
power" on the Model 712 and H P 9000 El SA, or "OK TO PRESS 
RESET BUTTON" on the Series 800 HP-PB. 

shutdown -h 

2. Observe antistatic precautions by following the guidelines as 
described in the related hardware manual. 

3. Model 712: 1 nstall the card following the instructions in the H P 
A4011A/ B Token Ring Adapter I nstallation and Configuration Guide 

HP 9000 EISA: Install the card in the slot you specified when 
running the eisa_config utility in "Configuration for (older) EISA 
Cards" in Chapter 2. 

I f you have a S715/33, S720, or S730 model, remove the EI SA system 
interface, insert the card into the card guide on the EISA interface, 
and placethe whole unit back intothe system following the 
instructions in the El SA Token Ring Quick I nstallation guide and the 
El SA Token Ring Ndtwork Adapter manual. If you have any other 
model, the El SA interface is not removable. 

Series 800 HP-PB: Set the ring speed on the card and install the 
card following the instructions in the H P-PB Token Ring Network 
Adapter manual. 


NOTE For systems with multi pie slots, always install cards in the lowest 

aval I able slot. HP recommends installing add-on LAN cards in the lower 
slots in the system backplane and then the add-on Token Ring cards in 
the higher slots in the system backplane. 
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Installing Token Ring 

Step 2: Installing Token Ring Hardware 


Table 1-2 


4. Attach the port of theToken Ring lobe cable to the card. Attach the 
other end of the cable to the Trunk Access Unit (TAU). Refer to the 
list below for valid cable types for each system. 


Valid Cable Types 


System Type 

Cable Type 

Model 712 

DB-9 or RJ 45 with media filter 

HP 9000 EISA 

RJ 45 or DB-9 

S800HP-PB 

DB-9 or RJ 45 with media filter 


5. Power up the system to complete the process. TheToken Ring card 
will run a self-test automatically. Any error messages will appear on 
the terminal display or system console. 

6. When the system is up and running, log in as root. 

7. HP 9000EISA only: Execute the dmesg command to verify the 
status of theToken Ring card. The following message should appear: 

"TOKENl STATUS: Opening adapter. . . .opened successfully" 

8. Execute ioscan -f to make sure the hardware path and driver are 
listed. Refer to flowchart 2A in Chapter 4, 'Troubleshooting Token 
Ring," for examples of ioscan output. Refer to Appendix A, 'Token 
Ring I nterface Card Statistics," for information on how to interpret 
the hardware path information. 

9. Proceed toChapter 2, "Configuring Token Ring," to configure the card. 
You'll also set the ring speed for the Model 712 using SAM. 
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Installing Token Ring 

Step 2: Installing Token Ring Hardware 


NOTE 


PCI Systems 

This section describes the installation procedure for a PCI Token Ring 
board. The following system classes are customer-install able: 

• A-Class 

• B-Class 

• C160 and higher 

• J 2240, J 5000, J 6000, and J 7000 

• L-Class 

• N-Class 

Although V-Class and Superdome systems have a PCI bus, they do not 
permit user installations. If you need to install PCI Token Ring on these 
machines, please contact Hewlett-Packard for service. 

If the level of detail in this document is not sufficient, please refer to your 
system's hardware user's guide for additional information about 
inserting or removing circuit cards. 

Photos of an A-Class system are included here for clarity. Your particular 
hardware may vary from what is shown. 


A new feature cal led "Online Addition and Replacement" or "OLAR" is 
supported in 111. This feature allows the PCI Token Ring card to be 
added or replaced without the need to power down or reboot the system. 
Seethe section "Online Addition and Replacement (OLAR) of PCI Token 
Ring Adapter" for additional information. 


Step 1. Exit all running programs and shut down the system by using this 
command: 

/sbin/shutdown -h 

Step 2. Wait unti I the system responds with "OK to press reset" or "H alted, you 
may now cycle power," and then power off the system. 

Step 3. Disconnect all attached cables and wires with the system placed on an 
anti-static, grounded surface if possible (see photo on following page). 

Step 4. Remove the appropriate cover or panel to expose the available system 
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Installing Token Ring 

Step 2; Installing Token Ring Hardware 

card slot(s). I n theexampleof the A-Class system shown on the following 
page, you must remove the two thumb-screws identified in the photo, 
then remove the chassis cover. 



Thumb screw 


Step 5. Locate an open card slot. 

Step 6. If the slot has a cover plate over the chassis opening, remove it and keep 
the attachment screw for use later. 

Step 7. Attach the grounding strap to your wrist or ankle. 

Step 8. Remove the PCI Token Ring card from its antistatic plastic bag. 

Step 9. Align the connector on the card with the slot connector. 

Step 10. Press the card firmly into place, making sure that the connector is fully 
i nserted. 
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Installing Token Ring 

Step 2: Installing Token Ring Hardware 



Step 11. Make sure the screw hole in the card's bulkhead lines up with the hole in 
the chassis assembly. Use the screw you saved from step 6 to attach the 
card's bulkhead to the chassis. 

Step 12. Replace the cover or panel that was removed i n step 4. 

Step 13. Re-attach all of the cables and wires. 

Step 14. Connect the A.C. power cable. 

Step 15. Power on the system. 

Step 16. Continue with the section "Step 3: Loading Token Ring Software." 
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Installing Token Ring 

Step 2: Installing Token Ring Hardware 

Online Addition and Replacement (OLAR) of PCI 
Token Ring Adapter 

This section is a summary of OLAR concepts that apply to OLAR-capable 
adapters. For more information on OLAR planning and preparation as 
well as detailed step-by-step procedures for adding or replacing an 
adapter, refer to Chapter 2 of the Configuring HP-UX for Peripherals 
manual (part number B2355-90698). This document may be ordered 
from H P, or you may view, download, and print it from the following 
website: http : / /docs . hp. com. 

The letters 0, L, A, and R stand for On Line Addition [and] Replacement. 
HP-UX Hi systems (L-Class, N-Class, and Superdome) are capable of 
allowing OL AR-capable adapters to be added or replaced without the 
need to shut down or reboot. The system hardware uses the per-slot 
power control combined with operating system support to enablethis 
feature. 

Certain classes of hardware are not intended for access by users. At this 
time, these include V-CI ass and Superdome systems. H P recommends 
that these systems be opened only by a qualified HP engineer. Failure to 
observe this requirement can invalidate any support agreement or 
warranty to which the owner might be entitled. 


NOTE If you plan to use OLAR, you may need to update your system firmware. 

For details about specific platforms, please refer tothe ReadmeBefore 
I nstalling or Updating to H P-UX Hi document provided with your 
system. 


I mportant Terms and Concepts of OLAR 

The addition or replacement of an OLAR-compatiblecard may be done in 
either one of two ways: 

1. Using the SAM utility. 

2. I ssui ng command-1 i ne commands usi ng rad. 
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Installing Token Ring 

Step 2: Installing Token Ring Hardware 


Table 1-3 


I mportant Terms 


Term 

Meaning 

OLAR 

All aspects of the OLAR feature 
including On-line Addition (OLA) and 
On-line Replacement (OLR). 

Power Domain 

A grouping of 1 or more interface card 
slots that are powered on or off as a unit. 
(Note: Multi-slot power domains are not 
currently supported.) 

target card / target card 
slot 

The adapter that will be added or 
replaced using OLAR, and the slot in 
which it resides. 

affected card / affected 
card slot 

The adapters and the slots in which they 
reside that are in the same power 
domain as the target slot. 


During a card replacement operation, SAM performs a Critical Resource 
Analysis, which checks the target card for critical resources that would 
be lost when the card is shut down. 

Planning and Preparation 

For the most part, SAM prevents you from performing OLAR procedures 
that would adversely affect other areas of the server. This is not true 
when using rad. 

On-line Addition When adding an interface card, the first issue that 
must be resolved is whether the new card iscompatiblewith the system. 
Each OLAR-capable PCI slot provides a set amount of power. The 
replacement card cannot require more power than is available. 

The card must also operate at the slot's maximum bus frequency. A PCI 
card must run at any frequency lower than its maximum capability, but 
a card that can only operate at 33 M Hz will not work on a bus running at 
66 MHz. rad provides information about the bus frequency and power 
available at a slot, as well as other slot-related data. 

On-line Replacement When replacing an interface card, you must 
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NOTE 


Installing Token Ring 

Step 2: Installing Token Ring Hardware 


replace the card with an identical card. This is referred to as I i ke-for-l i ke 
replacement and should be strictly adhered to. Using a similar but not 
identical card may cause unpredictable results. For example, a newer 
version of the target card, which is identical in terms of hardware, may 
contain an updated firmware version that could potentially conflict with 
the current driver. 

When the replacement card is added to the system, the appropriate 
driver for that card must be configured in the kernel before beginning 
the operation. SAM ensures the correct driver is present. If you have any 
question about the driver's presence, or if you are not certain that the 
replacement card is identical to the existing card, you can useioscan 
together with rad to investigate. 


If the PCI Token Ring card has a universally administered MAC address 
configured when the online replacement is performed, the new card's 
universally administered MAC address will be used. SNA users who plan 
to use online replacement with PCI Token Ring card on L-Class, N-Class, 
and Superdome platforms will be affected. Online replacement will 
require changing the configuration file for SNAplus2 to use the new 
universally administered MAC address. 
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Step 3: Loading Token Ring Software 

This section assumes that the board has been installed using the 
instructions found in the previous section (Step 2). Follow the steps 
below to load Token Ring software using the HP-UX swinstal I program. 

Model 712, H P 9000 EISA, or Series 800 HP-PB 
Systems 

1. Log in as root. 

2. I nsert the software media (tape or disk) into the appropriate drive. 

3. Run the swinstal I program using the command: 

swinstall 

This opens the Software Selection Window and Specify Source 
Window. 

4. Change the Source Host Name if necessary, enter the mount point of 
the drive i n the Source Depot Path field, and activate the OK button 
to return to the Software Selection Window. Activate the Help button 
to get more i nformation. 

The Software Selection Window now contains a list of available 
software bundles to install. 

5. H ighlight the Token Ring software for your system type. 

6. Choose Mark for Install from the "Actions" menu to choose the 
product to be installed. 

7. Choose Install from the "Actions" menu to begin product 
installation and open the I nstall Analysis Window. 

8. Activate the OK button in the I nstall Analysis Window when the 
Status field displays a Ready message. 

9. Activatethe Yes button at the Confirmation Window to confirm that 
you want to install the software, swinstall displays the I nstall 
Window. 

View the I nstal I Wi ndow to read processi ng data whi le the software is 
being installed, swinstall loadsthefileset, runs the control scripts for 
thefileset, and builds the kernel. When the Status field indicates 


Chapter 1 


29 




Installing Token Ring 

Step 3: Loading Token Ring Software 


Ready, activate the OK button and the Note Window opens. 
Estimated time for processing: 3 to 5 minutes. 

10. ActivatetheOK button on the Note Window to reboot the system. 
The user interface disappears and the system reboots. 

11. When the system reboots, check the log file in 

/ var/ adm/ sw/ swinstall.log and / var/ adm/ sw/ swagent.log to make 
sure the installation was successful. 

12. HP 9000 EISA only: Go to "Configuration for (older) EISA Cards" in 
Chapter 2. 


PCI Systems 

Preparation 

You can install PCI Token Ring software from your application media 
during a normal system operation where: 

1. The system is al ready booted up for operation. 

2. The system is up during the installation. 

3. Single-user state is not required. 

For patch requirements for 10.20 and 11.0, refer to the Release Notes. A 
core LAN products patch is required prior to installing the software and 
an additional patch is required prior to using SAM. 

Installation using "swinstall" 

1. Log in as root. 

2. I nsert the software media (tape or disk) into the appropriate drive. 

3. Run the swinstall program using the command: 

swinstall 

This opens the Software Selection Window and Specify Source 
Window. 

4. Change the Source Host Name if necessary, enter the mount point of 
the drive i n the Source Depot Path field, and activate the OK button 
to return to the Software Selection Window. Activate the Help button 
to get more i nformation. 
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The Software Selection Window now contains a list of available 
software bundles to install. 

5. H ighlight the Token Ring software for your system type. 

6. Choose Mark for Install from the "Actions" menu to choose the 
product to be installed. 

7. Choose Install from the "Actions" menu to begin product 
installation and open the I nstall Analysis Window. 

8. Activate the OK button in the I nstall Analysis Window when the 
Status field displays a Ready message. 

9. Activatethe Yes button at the Confirmation Window to confirm that 
you want to install the software, swinstall displays the I nstall 
Window. 

View the I nstal I Wi ndow to read processi ng data whi le the software is 
being installed, swi nstall loadsthefileset, runs the control scripts for 
thefileset, and builds the kernel. When the Status field indicates 
Ready, activate the OK button and the Note Window opens. 
Estimated time for processing: 3 to 5 minutes. 

10. ActivatetheOK button on the Note Window to reboot the system. 
The user interface disappears and the system reboots. 

Follow-up 

1. We recommended that you do a reboot after configuring 

/etc/rc.config.d/pcitrconf, but yoU Can execute 
/sbin/rc2.d/s3i5pcitr start to prevent a reboot. 

2. After reboot, check what (i) string on the kernel. Execute: 

what /stand/vmunix | grep Token 

You should see the foil owing on HP-UX 10.20 systems: 

A5783A/J1644AA HP PCI Token Ring <version> (<release>) 
<date> 

You should see the foil owing on HP-UX 11.x systems: 

A5783A/A4930A/J1644AA HP PCI Token Ring <version> 
(<release>) <date> 

Refer to the Release Notes for "<version>", "(<release>)" and "<date>" 
information. 
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Step 4: Setting a Card's Configuration 

Please refer to Chapter 2, "Configuring Token Ring," for information 
about configuring the Token Ring card. 
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This chapter describes how to configure the various Token Ring products. 
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Configuration for (older) EISA Cards 


NOTE The information in this section applies only to H P 9000 El SA Token 

Ring. The El SA bus version of Token Ring has been obsoleted as of J uly 
1999. Configuration information for this product is included herefor 
older systems who may still need to configure this product. 


Follow the steps below to set the EISA card link speed to the ring speed. 

1. Run the eisa_config utility in interactive mode using the command: 

eisa_config 

The screen display shows a slot number, configuration (CFG) file, and 
contents descri ption for each EI SA card. 

2. Verify that eisa_config displays either !FI WPCOOO at slot 0 for the 
S720/730 EI SA system board or !FI WPCOlO at slot 0 for the S750 
EI SA system board. 


NOTE If you inserted the hardware card into the El SA interface prior to 

installing the Token Ring software using the swinstal I utility, 
eisa_config may automatically recognize the card. If so, you should 
proceed to Step 4 below. 


Add theToken Ring card configuration file (!MDG0002) to the 
EE PROM memory chip on the EISA interface using the add 
command, followed by the slot number of the first available empty 
slot for the card, after the El SA prompt. I n the example below, 1 is 
the slot number chosen for the EISA Token Ring interface: 

add IMDG0002 1 

FI P recommends that you use the lowest empty slot. 

3. Execute the show board command followed by the slot number of the 
card to display the board's basic attributes. In the example below, 1 
indicates the slot number of the EISA Token Ring interface. 

show board 1 
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In the display, function names are prefaced with FI and F2, and 
choice options are prefaced with CFI1, CFI2, and so forth. 

Toset the cable connector type, executethe change command followed 
by the slot number of the card, F1 for cable connector type, and the 
choice option of the type you wish toset. For example, toset the cable 
connector type of the card in slot 1 to a RJ 45 connector, you must 
execute the command: 

change 1 FI CH2 

UseCFIlfora DB9connector (thedefault); useCFI2fora RJ 45 
connector. 

You MUST configure the card link speed to match the ring speed. To 
set the card link speed, execute the change command follow^ by the 
slot number of the card, F2 for the ring speed function, and the choice 
option of the speed you wish toset. For example, toset the card link 
speed of the card i n slot 1 to 16 M bit/s, you must execute the 
command: 

change 1 F2 CH2 

Use CFI 2 if the ring speed is 16 Mbps; use CFI 3 if the ring speed is 4 
Mbps. 

Do not change the interrupt level (F3). The setting is CFI 1 
(Level-sensitive). 

4. To save the new card configuration, execute the command: 

save 

N 0 switches or jumpers have to be changed. 

5. To leave the eisa_config utility, execute the command: 

quit 

If you have not encountered any error before issuing the quit 
command, ignore all messages displayed by eisa_config upon 
exiting. 


NOTE You can also use the eisa_config utility to reconfigure the connector 

type and the ring speed for your El SA Token Ring card. You must reboot 
the system when you are done with eisa_conf ig for the changes to take 
effect. 
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Configuration Using SAM 

Using SAM with Model 712, HP 9000 EISA, or Series 
800 HP-PB Systems 

Using SAM, configuring Token Ring can be divided into three 
procedures: 

• Step 1: Configuring the Token Ring link. 

Follow this step to add the I P/I nternet address, alias, and, if this 
Token Ring card is on a subnet, the subnet mask for your card, and to 
configure the ring speed (Model 712) and advanced options such as 
station address, MTU size, source routing, and the I nternet broadcast 
address. The procedure will automatically initialize theToken Ring 
link and enableyour node to connect to theToken Ring network. 

• Step 2: Configuring network connectivity. 

Follow this step to add remote aliases and remote host I P/I nternet 
addresses for network connectivity, and also to specify default 
gateway information. 

• Step 3: Verifying the installation. 

Follow this step to verify the installation. 

Step 1: Configuring theToken Ring link 


NOTE Make sure the Token Ring card and software are installed in the system 

before you use SAM to configure the software. 


Log in as root. Refer to the information on the Network Card 
Configuration Worksheet as you do the foil owing: 

1. At the FI P-UX prompt, type: sam 

2. Doubleclick Ndiworking and Communications at the SAM main 
wi ndow. 

3. Doubleclick Network I nterfaceCards at the Networking and 
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Communications window. 

4. Highlight the Token Ring interface card that you want to configure 
from the object list. If the card is not displayed, then gotoChapter 1, 
"I nstalling Token Ring," and check that your hardware has been 
properly installed. 

Model 712: The SAM object list always shows the name of the 
built-in LAN (I EEE802.3/Ethernet) as lanO, and the networking card 
in the slot in the backplane as lanl, whether it is an Ethernet or 
Token Ring card. If the ring speed has not been set, the card status 
may be "Disabled" or "Not configured." 

HP 9000 EISA: The SAM object list always shows the name of the 
built-in LAN (I EE E802.3/Ethernet) as lanO, and the first networking 
card in an El SA slot as lanl, whether it is Ethernet or Token Ring. 
The networking cards installed in other slots are named sequentially 
(Ian2, Ian3, etc), according to the order of the occupied slots. 

Series 800 HP-PB: If the system includes the pre-installed Token 
Ring option, it is lanO. If the system does not contain a built-in Token 
Ring card and your card is the first Token Ring card added to the 
system, it is lanl. 

5. Verify that the hardware path is correct for your Token Ring card. 
Model 712: The hardware path will be 5/0/7. 

HP 9000 EISA: The last number of the hardware path should match 
the backplane slot number of the card. For example, if the hardware 
path is 4/0/3, then the card should be in slot 3. 

Series 800 HP-PB: The hardware path should equal 4 times the 
hardware module number in which the card has been installed. For 
example, if the hardware path is 32, then the card should be in 
hardware module 8. 

6. Choose Configure from the "Actions" menu to open the Configure 
LAN Card window. Enter the information about theToken Ring card. 
To do so, press the Tab key to move through the data entry fields. 


NOTE SAM displays the Card Name, Hardware Path, and Station Address 

fields with the appropriate values. These fields cannot be modified. 


a. Verify that the type of your card is Token Ring. 
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b. Model 712 only: Enter the ring speed. It must match the speed of 
the ring. 


NOTE El SA Token Ring speed is configured in the eisa_config utility. S800 

HP-PB Token Ring speed is physically configured on the card. 


c. Enter the I nternet address for your Token Ring card. 

Upon exiting the internet Address field, SAM checks to make 
sure that the I P/I nternet address you entered is correctly 
formatted and is not currently in use. 

d. Optionally, choose Add Aliases to open the Add Aliases window 
to assign aliases for the local host. 

You must complete this step if you have more than one network 
card installed in your system. You can also modify or remove alias 
names for your card on this menu. 

Activate the OK button to perform the task and return to the 
Configure LAN Card window. 

e. Optionally, at the Configure LAN Card window, you may enter the 
subnetwork mask for your subnetwork 

f. Optionally, enter comments about your card. 

g. Optionally, choose "Advanced Options" to open the "Configure 
Advanced Options" window. You can change or configure your 
station address, the I nternet broadcast address, the maximum 
transmission unit (MTU) size, and/or source routing on this 
screen. 

For HP-PB and EISA Token Ring, you can install patches to 
increase the MTU sizeto4500. Refer to Table 3-2 for a list of 
patches. 

Activate the SAM on-line help for additional information on these 
options. 

Activate the OK button to perform the task and return to the 
Configure LAN Card window. 

7. Activate the OK button at the Configure LAN Card window to 
configure and enable your Token Ring card. 
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If the software is correctly configured, SAM displays the Network 
Card Configuration object list with the status Enabled for your card; 
otherwise, SAM displays an error message. 

8. At the Network I nterface Card menu, select Exit from the "File" 
menu. 

9. Choose Exit SAM from the "File" menu at the Networking and 
Communications window. 

I f you have moved or removed any Token Ring cards from the system, 
FI P recommends that you verify the I P/I nternet address of every card 
in the backplane before leaving SAM. 

10. Verify that theToken Ring device files have been created correctly by 
executi ng the FI P-U X commands: 

cd /dev 
Is -1 Ian* 

If theToken Ring device file has not been created, execute the script: 

/usr/sbin/hptoken_init devfile 

Refer to Chapter 3, 'Token Ring Resources," for descriptions of Token 
Ring devicefiIes. If you want to configure your system for network 
connectivity, continue with the next section, "Step 2: Configuring 
Network Connectivity". If not, continue to "Step 3: Verifying the 
I nstallation." 

Step 2a: Configuring network connectivity on systems running 
HP-UX version 10.20and earlier 

Your system may not be able to communicate with other systems (for 
example, PCs, workstations, and servers) until you configure 
system-to-system connections by adding an entry in / etc/ hosts for the 
remote system. You can use SAM to do this by completing the following 
steps: 

1. At the FI P-UX prompt, type: sam 

2. Doubleclick Ndiworking and Communications at the SAM main 
wi ndow. 

3. Double click I nternet Addresses to configure your system to 
communicate with other systems using theTCP/l P protocol. 

SAM displays the remote system names and I nternet addresses that 
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are already configured. 

4. Choose Add from the "Actions" menu to open the Add I nternet 
Address wi ndow to add the i nternet address and system name of a 
remote system. 

Use the SAM on-line help system for information about adding 
remote system connections. 

a. E nter the I nternet address for the remote system. 

Upon exiting the internet Address field, SAM checks to make 
sure you have entered a valid I P/I nternet address. SAM also 
determines if a gateway is required for the connection. If a 
gateway is required, SAM displays fields for entering gateway 
information for this remote system connection. Use the SAM 
on-line help system for information about gateways. 

b. E nter the remote system name. 

Upon exiting the Remote System Name field, SAM checks to make 
sure that connectivity has not already been configured for this 
system. If it has, SAM displays an error message. 

c. Optionally, choose Add Aliases toopentheAdd Aliases window if 
you want to configure aliases for a remote system. 

You can modify or remove alias names for a remote system on this 
menu. 

Activate the OK button to perform the task and return to the Add 
I nternet Address window. 

5. Activate the OK button to enable your system to communicate with 
this system and return to the I nternet Addresses object list. 

SAM updates the object Iist to include the remote system you 
configured. 


NOTE You can modify or remove remote systems and modify default gateways 

by highlighting the Remote System Name from the object list and 
choosing Modify, Remove, or Modify Default Gateway from the "Actions" 
menu. 


6. Choose Exit from the "File" menu. 
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7. At the Networking and Communications window, choose Exit SAM 
from the "File" menu to leave SAM. 

8. Verify remote system configuration. 

a. View the list of remote systems you can communicate with by 
typing the foil owing command at the H P-UX prompt: 

more /etc/hosts 

b. View the configured destinations reached through gateways and 
the gateways used to reach those destinations by typing the 
following command at the HP-UX prompt: 

netstat -r 

To verify that you can communicate with a remote system via the 
Token Ring product, continue to "Step 3: Verifying the I nstallation." 

Step 2b: Configuring network connectivity on systems running 
HP-UX version 10.30and later 

Your system may not be able to communicate with other systems (for 
example, PCs, workstations, and servers) until you configure 
system-to-system connections by adding an entry in / etc/ hosts for the 
remote system. You can use SAM to do this by completing the following 
steps: 

1. At the H P-UX prompt, type: sam 

2. Doubleclick Networking and Communications at the SAM main 
wi ndow. 

3. Doubleclick Hosts and then Local Hosts Fileitemtoconfigureyour 
system to communicate with other systems using theTCP/l P 
protocol. 

SAM displays the remote system names and I nternet addresses that 
are already configured. 

4. Choose Add from the "Actions" menu to open the Add Host to File 
window to add the internet address and system name of a remote 
system. 

Use the SAM on-line help system for information about adding 
remote system connections. 

a. E nter the I nternet address for the remote system. 
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Upon exiting the internet Address field, SAM checks to make 
sure you have entered a valid I P/I nternet address. SAM also 
determines if a gateway is required for the connection. If a 
gateway is required, SAM displays fields for entering gateway 
information for this remote system connection. Use the SAM 
on-line help system for information about gateways. 

b. E nter the remote system name. 

Upon exiting the Remote System Name field, SAM checks to make 
sure that connectivity has not already been configured for this 
system. If it has, SAM displays an error message. 

C. Optionally, choose configure Aliases to open the Configure 
Aliases window if you want to configure aliases for a remote 
system. 

You can modify or remove alias names for a remote system on this 
menu. 

Activate the OK button to perform the task and return to the Add 

Host to File window. 

5. Activate the OK button to enable your system to communicate with 
this system and return to the Hosts window. 

SAM updates the object list to include the remote system you 
configured. 


NOTE You can modify or remove remote systems and modify default gateways 

by highlighting the Remote System Name from the object list and 
choosing Modify, Remove, or Modify Default Gateway from the "Actions" 
menu. 


6. ChooseExit from the "File" menu. 

7. ChooseExit SAM from the "File" menu to leave SAM. 

8. Verify remote system configuration. 

a. View the list of remote systems you can communicate with by 
typing the foil owing command at the FI P-UX prompt: 

more /etc/hosts 

b. View the configured destinations reached through gateways and 
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the gateways used to reach those destinations by typing the 
following command at the HP-UX prompt: 

netstat -r 

To verify that you can communicate with a remote system via the 
Token Ring product, continue to "Step 3: Verifying the I nstallation." 

Step 3a: Verifying the installation on systems running HP-UX 
version 10.20 and earlier 

Once your Token Ring software is installed, fully configured and 
running, you should run the following commands to verify hardware and 
software installation. Refer to the on-line man pages for complete 
descriptions of the commands listed below. 

1. Tocheck that the link is working, run the linkloop command. 

I n this linkloop example, 5 is the Network Management ID (NMID) of 
your Token Ring card and 0x100090000222 is the station address of a 
local or remote node. (You can obtain the NMID and the local station 
address from the lanscan command.) 

linkloop -i 5 0x100090000222 

Token Ring installation is verified if linkloop succeeds to the local 
station address. You can further verify the link by doing the foil owing 
steps. 

2. Tocheck that the network connection is working, enter the ping 
command at the HP-UX prompt. I n this example, 191.2.1.2 is the 
configured I P/I nternet address of the remote system. 

ping 191.2.1.2 

3. To view information about the station address, hardware state, and 
network interface state of your Token Ring card, enter the lanscan 
command at the HP-UX prompt as shown below: 

lanscan 

4. To show the number of packets sent or received, and any link errors, 
enter the netstat -i command at the H P-UX prompt as shown below: 

netstat -1 

5. To show the status of the Token Ring interface, enter the lanadmin 
diagnostic command at the H P-UX prompt as shown below: 
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lanadmin 

After enteringthe utility, enter the following lanadmin menu 
commands in sequence to show the status of the Token Ring device 
with the NMID of 5. 

Ian 

nmid 5 
display 

To exit the utility, enter: 

quit 

Refer to Appendix A for a description of the lanadmin display fields. 

Step 3b: Verifying the installation on systems running HP-UX 
version 10.30 and later 

As of 10.30, there were a number of changes in the various commands 
that may be used to verify the installation of a Token Ring board. This 
section provides information about these changes. 

• Data Link Provider I nterface (DLPI) 

As of 10.30, several changes were made to the DL PI driver to support 
the Streams-based networking stack. 

PPA number. The PPA number for DLPI is no longer equivalent to 
the network management identifier (nmid). The PPA number has 
been changed to be the same as the card i nstance number. 

Source routing. Token Ring source routing is no longer 
enabled/disabled via lanconfig. The lanconfig command is not 
supported in 10.30. Token Ring source routing is now 
enabled/disabled via the lanadmin command with the rif/-rif options. 

Impact. The PPA change will potentially have the greatest impact. 
Applications that assume the nmid is the PPA number need to make 
changes to use the card i nstance number i nstead. The other changes 
only affect drivers that require support through Hewlett-Packard's 
common DLPI implementation. 

• lanscan 

As of 10.30, LAN drivers do not maintain interface state. I n 10.20, 
lanscan displayed the interface state of each networking device. This 
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can no longer be done in 10.30. Therefore, the Network I nterface 
State field has been removed. I nstead, the netstat command can be 
used to determi ne the state of the i nterface: 


$ netstat -i 


Name 

Mtu 

Network 

Address 

Lpkts 

Opkts 

loO 

4136 

127.0.0.0 

127.0.0.1 

128 

164 

lanO 

1500 

15.13.136.0 

15.13.136.73 

103838 

20238 

lanl * 

1500 

none 

none 

0 

0 


The asterisk (*) after lanl indicates that it is DOWN. 

Until 10.20, lanscan displayed the interface unit number in the 
Network I nterface NameU nit field. In 10.30, lanscan displays the 
Physical Point of Attachment number (PPA^. This is the same as the 
card instance number if the H P-supported common DLPI is used. 

The driver-specific major number is replaced by the DLPI major 
number in both normal and extended display. This number is the 
same for HP drivers that use the HP-supported common DLPI. For 
third party drivers and H P drivers that provide their own DLPI, this 
need not be true. The field, HP-DLPI Support, indicates whether the 
H P-supported common DLPI is used. 

Two new options have been added: -m is used to display the MAC 
type and -p is used to display the PPA# The -n option functions as it 
did in 10.20. 

Driver-specific information will be displayed after the extended 
station address and encapsulation. Included in the driver-specific 
information are the driver name, which is stored in the hwift name 
field, and, for the H P-PB and built-in FDDI interfaces, the 
driver-specific major number. 

The purpose of displaying the driver name is to distinguish a lOOVG 
interface from a non-VG interface. 

The executables that parse the lanscan output will have to be 
changed. Seethe lanscan manpagefor details. 

The PPA#is no longer equal tothe NMID as it was in 10.20. 
Programs that get the NMID from lanscan and expect it to be the 
same as PPA#should be changed to get the PPA#instead. 

Network management tools and some driver start-up scripts that use 
N MID must be changed. Any tool that depends on PPA#to be the 
same as NMI D needs to be changed. See the-p option for details. 
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• ifconfig 

Another way of finding the interface state is by using ifconfig: 

$ ifconfig lanO 

lanO: flags=643<UP,BROADCAST,RUNNI NG,MULTICAST>... 
inet 15.13.136.73 netmask fffffSOO broadcast 15.13.143.255 

$ ifconfig lanl 

lanl: flags=842<BROADCAST,RUNNING,MULTICAST>... 
inet 0.0.0.0 netmask 0 

Interface names. I nterface names used for ifconfig commands and 
/etc/rc.config.d/netconf statements can havea logical instance number 
appended to the card name (for example, Ian0:l). The new syntax is: 

name X[: logical_instance ] 

where: 

name is the class of interface, such as Ian (Ethernet LAN, Token Ring, 
FDDI, or FibreChannel links), snap (IEEE802.3 with SNAP 
encapsulation), atm (ATM), du (Dial-up), ixe(X.25), and mfe(Frame 
Relay). 

X is the Physical Point of Attachment (PPA). This is a numerical 
index for the physical card in its class. For LAN devices, the lanscan 
command will display the nameand PPA number concatenated (such 
as lanO) in the Net-1 nterface NamePPA column. 

• lanadmin 

lanadmin uses PPA#instead of NMID. 

lanadmin supports a new option -B on| off to enable/disable source 
routing with Token Ring, -b displays the state of source routing. 
Similar functionality was provided by lanconfig until (and including) 
10 . 20 . 

Executables that rely on NMID have to be changed. Also, if you use 
lanconfig to enable/disableToken Ring source routing, you must now 
use lanadmin. Seethe lanadmin manpagefor details. Also, driver 
start-up scripts must be changed if they rely on NMID to be used by 
lanadmin. 

• linkloop 

linkloop uses PPA#instead of NMI D. 
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Executables that rely on NMID have to be changed. Seethe I inkloop 
man page for details. 

• lanconfig 

As of 10.30, lanconfig no longer exists. Instead, lanadmincan be used 
to enable/disableToken Ring source routing. 

The Token Ring rif option (source routing) is now part of the 
lanadmin command. 

To disable source routing: 

/usr/sbin/lanadmin -B off <PPA_number> 

To enable source routing: 

/usr/sbin/lanadmin -B on <PPA_nuniber> 

To display the current setting: 

/usr/sbin/lanadmin -b <PPA_nuniber> 

By default, source routing is enabled on Token Ring devices. Usethe 
lanscan command to determine the PPA numbers for LAN devices. 

Using SAM with PCI Systems 

A SAM patch is required to configure PCI Token Ring. Refer to the 
Release Notes. 

Configuration is done using the Networking and Communications 
Network I nterfaceCard's screen. Please refer to "Manual Installation 
and Configuration" in Chapter 3 for details on performing manual 
configuration. 


NOTE Use either SAM or manual configuration, not both. 


1. Select theToken Ring link to be configured. 

2. Note that setting incorrect parameters can render your network 
inoperable and will prevent theToken Ring I ink from connecting to 
the network. Exercise caution while modifying parameters. 

3. Enabling autosense will allow the I ink to sense the speed and duplex 
sett! ng of the network and configure itself. See items l.f and l.g I n the 
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"Manual Configuration for PCI Systems"salion in Chapter 3 before 
enabling autosense. 

4. If autosense is enabled, the only remaining configuration items arel P 
configuration, station address, and MTU. Skip to step (6) below. 

For 100 M b/s operation, select autosense, as it cannot be enabled 
otherwise. 100 M b/s can only be enabled on A5783A when usi ng 
autosense and when the adapter is connected to a 100 M b/s port. Also, 
software A5783A revision B.11.00.04 or later must be installed. 

On-line diagnostics (I PR 9904 and later) may be used to distinguish 
between A4930A (4/16 PCI Token Ring) and A5783A (4/16/100 PCI 
Token Ring). 

Alternatively, ioscan(lM) can be used to distinguish between A4930A 
and A5783A if revision B.11.00.06 or later is installed. 

Also, note caveats l.a through l.g in the "Manual Configuration for 
PCI Systems"section in Chapter 3. 

5. If autosense is disabled, speed and duplex must be configured. Setting 
the speed to "0" (zero) is not supported. 

6. IP address, subnet mask alias, and enabling DHCP configuration is 
the same as i n other I i nks. 

7. "Advanced Options": 

• If setting the station address, please note that PCI Token Ring 
does not support changing the station address to another globally 
administered address. Only locally administered addresses are 
supported. The only global addresses supported are: 

- The card's own MAC address. 

- An address of all zeroes, which is treated the same as the card's 
unique address. 

• The MTU must beset to a non zero value for the link to function. 
See l.e in the "Manual Configuration for PCI Systems" section in 
Chapter 3. 

SAM may set the default MTU to "0" (zero) when configuring a 
card for the first time. The user must check and correct this 

SAM does not support setting the Rl F option for PCI Token Ring in 11.x. 
(PCI Token Ring does not support boot time configuration of Rl F in 
10.20.) This needs to be manually configured as detailed in the "Manual 
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Configuration for PCI Systems"salion in Chapter 3. 

SAM configuration of any parameter will overwrite RIF information. RIF 
configuration should be done manually after SAM configuration of other 
parameters. 
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Table 2-1 


Setting Speed and Duplexity 

Speed changes may beset by editing pcitrconf, using SAM, or by using 
lanadmin (IM) . To enable 100 Mb/s operation with A5783A connected to 
a 100 M b/s port, use lanadmin -X AUTO_ON. Refer to the fol lowi ng table 
for lanadmin parameter values. 

lanadmin supports the "-X <option>" to change speed and duplex mode. 

lanadmin "-X" options 


-X <option> 

Speed and Duplex Mode Meaning 

4HD 

4 Mb/s - FIalf duplex 

16HD 

16 Mb/s - FI alf duplex 

4FD 

4 Mb/s - Full duplex 

16FD 

16 Mb/s - Full duplex 

AUTO_ON 

Autosense and 100 M b/s operation 


Please refer to earlier warnings about incompatible settings. 
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Status Light Emitting Diodes (LEDs) 

The bulkhead of each Token Ring board contains two connectors and two 
Light Emitting Diode indicators (LEDs). Below is an exampleof the PCI 
Token Ring board. 
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Table 2-2 


The foil owing table shows the functional status of the board as indicated 
by the "Error" (Amber) and "Link" (Green) LEDs. 

Status LEDs 


* 

Amber - 
"Error" 

Green - 
"Link" 

Explanation 

X 

Blinking 

Blinking 

The adapter is waiting for initialization. 


Off 

Off 

The adapter initialization is in progress 
or the system is not powered on. 


Off 

Blinking 

The adapter did not detect any problems 
during self-diagnostic tests and is 
waiting to open. 

NOTE: If this state occurs after the 
adapter has been opened, this indicates 
that the adapter has been closed via 
software control / cable disconnect. 


Off 

On 

The adapter is open/operating correctly. 

X 

On 

Off 

The adapter self-diagnostic tests failed or 
there is a problem with the adapter. 


Blinking 

Off 

The adapter is closed due to an 
undetected error. One of the following is 
possible: 

* The adapter open failed. 

* The adapter detected a wi re fault. 

* The adapter failed auto-removal test. 


Blinking 

On 

The adapter has detected beaconing or a 
hard error. 

X 

On 

On 

The adapter has failed before running its 
self-diagnostics. 


NOTE: Only those items with an "X" in the column are possible prior 
to configuration. 
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To maintain and administer Token Ring, use the following resources: 

• HP-UX Manual Reference Pages. 

• Logging Messages. 
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• Manual I nstalIation and Configuration. 

• Token Ring Device Files. 

• Contacting Your HP Representative. 
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HP-UX Manual Reference Pages 

While installing, configuring, or troubleshooting Token Ring, you may 
need to refer to any of the foil owing on-line manual reference pages (man 
pages) for useful H P-UX operating system or Token Ring commands. To 
display a man page, type the following at the system prompt: man 
<command name>. For example, man arp. 

• arp(lM) displays and modifies the I nternet-tostation address 
mapping tables used by the Address Resolution Protocol. 

• eisa_config(lM) interprets information stored in configuration files 
and uses it to configure system resources needed to properly interact 
with EISA cards on HP 9000 EISA workstations. You should also use 
eisa_config to set the El SA Token Ring card link speed and cable 
connector type. 

• hosts(4) contains database that contains a single line entry for each 
host name entry. 

• ifconfig(lM) assigns an address to a network i nterface and 
configures and displays network parameters. 

• ioscan(lM) scans system hardware, usable I/O system devices, or 
kernel I/O system data structures as appropriate, and lists the 
results. 

• lanadmin(lM) resets or reports the status of the LAN card including 
Token Ring. 

• lanscan(lM) displays information about LAN cards that are 
successfully bound to the system. 

• linkloop(lM) verifies network connectivity through the Data Link 
Layer (OSI Layer 2). 

• netfmt(lM) formats common tracing and logging binary files. 

• netstat(l) provides network statistics and information about 
network connections. 

• nettl(lM) logs network events and trace packets as they enter and 
exit theToken Ring driver. 

• ping(lM) verifies network connectivity through the Network Layer 
(OSI Layer 3) and reports the round-trip time of communications 
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between the Icxcal and remote hosts. 

• rad(lM) performs OLAR functions without any comprehensive 
checks. 

• route(lM) adds and deletes entries to the network routing table 
about gateways. 

• sam(lM) configures networking software and sets the ring speed on 
Model 712 and configures the PCI Token Ring link. 

• swinstall(lM) loads software file sets onto 10.x and 11.x systems. 
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Logging Messages 

Token Ring uses the nettl(lM) logging and tracing facility supplied with 
HP-UX. Although this utility is also documented in manpages and other 
documents, it is included here for the user's convenience. 

You may access the logging and tracing utility using either the graphical 
user interface (GUI) version (nettladm) or the command Iine interface 
(netti/ netfmt) 

Features of the GUI version, which are now a part of your HP 9000 
system, include: 

• An interface which guides you through logging and tracing tasks. 

• An interface which allows you to create and format reports. 

• The capability to collect logging and tracing subsystem-specific 
information. 

• Report screens which are updated instantaneously with current 
logging and tracing information by the subsystem. 

• Context-sensitive on-line help. 

To access the GUI version of the logging and tracing utility, run the 
command below. Refer to the ndttladm(lM) man page for information on 
using the GUI version. 

nettladm 

Listed below are some example commands using the command line 
interface. Refer to the n^l(lM) and netfmt(lM) manual (man) pages for 
information on using the command line interface 

• To examine the log file with cause and action descriptions: 

netfmt -v -f /var/adm/nettl.LOGOO 

The -V option enables the reporting of avail able cause and action 
descriptions for each log message. A sampleToken Ring log message 
using the -v option is shown below. 
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Timestamp 
Process ID 
User ID (UID) 
Device ID 
Connection ID 


Mon Dec 12PST 1994 
750 
0 
1 
0 


03:40:10.555252 


Subsystem 
Log Class 
Path ID 
Log Instance 


TOKEN 

DISASTER 

0 

0 


<1317> Token Ring driver encountered a lobe error on 
interface unit <1>; reset or reboot 

(Disaster) Verify the physical connections from your system to the ring. Then 
use the lanscan(lM) command to find the NMID of the Token Ring card. Use the 
lanadmin(lM) command to reset the card. Reboot if necessary. If rebooting is 
ineffective, follow the troubleshooting flowcharts in the documentation in 
sequence until the problem is solved. The HP internal error code is <-l>. 

• To examine just the log messages in the log file: 

netfmt -f /var/adm/nettl.LOGOO 

A sampleToken Ring log message using just the -f option is shown 
below. 




Timestamp 
Process ID 
User ID (UID) 
Device ID 
Connection ID 


Mon Dec 12PST 1994 
750 
0 
1 
0 


03:40:10.555252 


Subsystem 
Log Class 
Path ID 
Log Instance 


TOKEN 

DISASTER 

0 

0 


<1317> Token Ring driver encountered a lobe error on interface unit <1>; reset 
or reboot 

• To check network logging and tracing status: 

nettl -status 

• For non-PCI systems, to start Token Ring tracing to the file 
/ tmp/ tracefileTRCO: 

nettl -traceon all -entity token -file /tmp/tracefile 

nettl(Im) adds the .TRCO postfix for you. 

• For PCI systems, to start Token Ring tracing: 

nettl -traceon all -entity pcitr -file /tmp/tracefile 

• For non-PCI systems, to stop Token Ring tracing: 

nettl -traceoff -entity token 


58 


Chapter 3 







Token Ring Resources 

Logging Messages 


• For PCI systems, to stop Token Ring tracing: 

nettl -traceoff -entity pcitr 

• To format the Token Ri ng trace file into the file/tmp/traceout: 

netfmt -f /tmp/tracefile.TRCO > /tmp/traceout 

Refer to the netfmt(lM) man page for further information about this 
command and how to create a filter for trace formatting. 

Messages Logged on a Cable Disconnect/Re-connect 
(PCI Token Ring) 

The NetTL message logged for cable disconnect is different for 16/4 M b/s 
and 100 M b/s operation: 

I n 4/16 M b/s, the message logged is: 

"Cable disconnected/faulty" 
class ERROR #2009 

I n 100 M b/s, the message logged is: 

"Internal error after beacon auto removal process" 
class ERROR #2010 

I n either case, when the cable is re-connected, the following message will 
be seen: 

"Link back online" 
class INFO #4001 

Starting with B.11.00.06, the above messages have changed. The cable 
disconnect message will be logged as an ERROR message to the nettl 
subsystem, as follows: 

The PCI Token Ring adapter driver detected a possibly 
faulty/disconnected cable at <hardware path>. 

On a cable re-connect, an IN FORMATIVE message will be logged to the 
nettl subsystem, as follows: 

The PCI Token Ring adapter driver detected that the link has 
been re-established at <hardware path>. 
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Manual Installation and Configuration 

For Non-PCI Systems 

HP recommends that you install your Token Ring software using 
swi nstal I and configure it usi ng SAM. 

Follow the steps below to manually install and configureyour Token 
Ring product. Refer todetailed instructions in the I nstalling and 
Administering LAN/ 9000 Software manual for additional information. 
The section for manually configuring a PCI system follows this one. 

1. Complete all the prerequisites in "Step 1: Checking Token Ring 
Installation Prerequisites"in Chapter 1. 

2. I nstal I the Token Ring software using swi nstal I and regenerate the 
kernel (refer to "Step 3: Loading Token Ring Software" in Chapter 1). 
Follow the detailed instructions in Chapter 3, "Manually Configuring 
LAN/9000" in the I nstalling and Administering LAN/ 9000 Software 
manual if you need to manually create a new kernel. You may need 
some of the foil owing Token Ring-specific information when you 
follow those steps. 

• Model 712 driver keyword: token3 

• HP 9000 EISA driver keyword: token 

• Series 800 H P-PB driver keyword: token2 

3. I nstal I the hardware. Refer to instructions in "Step 2:1 nstalling 
Token Ring Hardware" in Chapter 1. 

4. Verify theToken Ring devicefiles. Todoso, refer to instructions in the 
next section, 'Token Ring Device Files (obsolete)". 

• Model 712 device major number: 160 

• HP 9000 EI SA device major number: 102 

• Series 800 H P-PB device major number: 103 

5. Edit theToken Ring configuration files: / dtc/ rcconfig.d/ ndiconf and 
/ etc/ rcconfigd/ hptokenconf. 

This step is equivalent to configuration using SAM. Token Ring 
configuration is kept in thendtconf and hptokenconf files. See "Editing 
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/ etc/ rcconfigd/ netconf" in Chapter 3 of the I nstalling and 
Administering LAN/ 9000 Software manual for details. Note that for 
Token Ring, the encapsulation method is not configurable. 

The I nternet configuration information in the netconf file should be 
similar to the information displayed in the example below. 

IP_ADDRESS[11=192.20.20.122 

SUBNET_MASK[1]=255.255.255.0 

LANCONFIG_ARGS[l]="rif" 

INTERFACE_NAME[1]=lanl 

BROADCAST_ADDRESS[1]=192.20.20.255 

The valid value for LANCONFIG_ARGS is"rif"or "-rif." 

The Token Ring-specific link configuration information in the 
hptokenconf file should be similar to the information displayed in the 
example below. 

HP_TOKEN_INTERFACE_NAME[0]=lanl 
HP_TOKEN_STATION_ADDRESS[0]=0x10009090c8EE 
HP_TOKEN_MTU[0]= 417 0 
HP_TOKEN_RING_SPEED[0]= 

Notethat HP_TOKEN_RING_SPEED is used for the M712 only. 
Valid values are 16000000 or 4000000. 

For FIP-PB and EISA Token Ring, you can install patches to i ncrease 
the MTU size to 4500. Refer to Table 3-2 for a list of patches. 

6. Activate your configuration. You can reboot the system to activate the 
configuration or execute the ifconfig or lanadmin commands 
manually or startup the scripts /sbin/rc2 .d/s340net and the 
proper script for your interface (e.g. /sbin/lnlt.d/hptokenfor 
FI P-PB). When you configure Token Ring using SAM, SAM executes 
these commands for you. Using the netconf and hptokenconf examples 
above, you will execute: 

lanadmin -A 0xl0009090C8EE 5 

ifconfig lanll92.20.20.122 netmask 255.255.255.0\ 
broadcast 192.20.20.255 

This example assumes the NMID of the Token Ring link is 5 (use 
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lanscan(lM) tofind the NMID). lanadmin(lM) sets the station 
address and the MTU size (if different from the default). ifconfig(lM) 
configures the IP address and masks. 

7. Refer to the I nstalling and Administering LAN/ 9000 Software 
manual for the edits required to/ etc/ hosts, / etc/ services, 

/ etc/ networks, and / etc/ protocols. 

Manual Configuration for PCI Systems 

At this point, it is assumed that you have already installed the PCI 

Token Ring board intothe backplane of your system. If this has not yet 

been done, please refer to the appropriate section of Chapter 1 for 

instructions about doing this before continuing with this section. 

1. If you have A5783A hardware, install A5783A or TokenRing-00 
software bundle. If you haveA4930A hardware, install A4930A or 
TokenRing-00 software bundle. If you have both, install both software 
bundles. 

2. Execute lanscan(lM) todeterminethe PPA numbers of the Token 
Ring interfaces. 

3. If a PCI Token Ring interface has not been configured, lanscan will 
show its MAC address as all zeroes. This is ok. 

4. Determine which interfaces you want enabled. 

I mportant! 

Starting with B. 11.00.02, you may choose to configure the card and IP 
manually or by using SAM. It is recommended that once a method 
has been chosen, that method be followed whenever new PCI Token 
Ring cards are configured or existing cards are reconfigured on the 
system. 

For 10.20 and 11.0, a patch is required prior to using SAM. Seethe 
current Release Notes for patch information. 


NOTE 100 M b/s operation is supported on B.10.20.00 or later and B.11.00.04 or 

later and when the requirements shown below are met. 


1. Edit /etc/rc.config.d/pcitrconf and Specify the parameters for 
each interface that is to be enabled. Follow the instructions in the file 
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on how to configure each interface. 

Please note that setting incorrect parameters can render your 
network inoperable and will prevent the Token Ring link from 
connecting to the network. Please exercise caution while modifying 
parameters. 

Please note the foil owing: 

a. Starting with B.11.00.01, the parameter names in pcitrconf 
have changed. On B. 10.20.00 or later, only new names may be 
used. Refer to the foil owing table for a list of old and new names. 
Use of the new names is encouraged but the old names will work 
during the transition period. Refer to the instructions in the 
comment section of the file. 

Table 3-1 Old vs New Parameter Names 


Old Name 

New Name 

PCITRSPEED 

PCITR_RING_SPEED 

PCITRFDX 

PCITRDUPLEX 

PCITR_MACADDR 

PCITR_STATION_ADDRESS 


NOTE Using old names will result in a warning in /etc/rc. log during each 

boot. 


b. The interface name can be found from lanscan (im) . 

c. Not all interfaces need to be configured, only those that are going 
to be used. 

d. Either autosense or speed/FDX (full duplex), but not both, can be 
specified. If both are specified, autosense will override speed/FDX. 

e. Although Token Ring supports an MTU of 18000 bytes for a speed 
of 16 M b/s (and 100 M b/s), most switches do not go that high. 
Switches vary in the amount of buffering provided. Some support 
MTU's as low as 4540 bytes. MAUs support 18000, but they do not 
support full duplex (FDX). Consult your switch manual before 
configuring the MTU. 
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Also note that HP-PB (J 2166A) and EISA (J 2165A andj 2638AA) 
currently support an MTU of 4170 bytes. If PCI Token Ring is to 
be connected toa network containing HP-PB Token Ring, it is best 
to set PCI Token Ring's MTU at 4170. 

Thefollowing patches or patches that supersedethem allow MTUs 
of up to4500 bytes on HP-PB and EISA Token Ring: 


Patches Required to Increase MTU Size 



10.20 

11.0 

HP-PB 

PHNE_17536 

PHNE_17355 

EISA 

Not available 

PHNE_17942 


No patches are required for Hi. 

f. I n a shared ring (stations are connected by a MAU), the first 
station to enter the ring should not use autosense. The remaining 
stations can use autosense. If autosense is not used, the speed 
should match the first station. FDX cannot be enabled in a shared 
ring environment. 

To configure 100 M b/s operation, enable autosense. 100 M b/s 
operation is supported only when all of thefollowing requirements 
are met: 

1. A5783A is used. 

On-line diagnostics (I PR 9904 and later) may be used to 
distinguish between A4930A (4/16 PCI Token Ring) and 
A5783A (4/16/100 PCI Token Ring) in 11.x. Starting with 
B.11.00.06, ioscan(iM) can also be used to distinguish 
between the two. 

2. The adapter is connected to a 100 M b/s port. 

3. Software A5783A revision B.10.20.00 or later or B.11.00.04 or 
later is installed. 

4. Autosense is enabled. 
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NOTE If full-duplex is enabled and the requirements of g.l through g.3 above 
are satisfied, the adapter will sense and configure itself to 100 M b/s 
operation regardless of the speed setting. This is not supported. 

A 100 Mb/s switch port cannot support 4/16 Mb/s operation. Manually 
sett! ng 4 or 16 M b/s when A5783A is connected to a 100 M b/s switch port 
is not supported. 

Connecting A4930A to a 100 M b/s switch port is not supported. 


Starting with B.11.00.06, a new option has been added to 
/etc/rc.config.d/pcitrconf: PCITR_RIF. This Can be USed 
to enable/disable source routing on a per interface basis and 
can beset to ENABLE or Dl SABLE. The default is ENABLE. 
Notethat SAM support for this option is not yet available. 

SAM configuration of any parameter will overwrite Rl F 
information. Rl F configuration should be done manually after 
SAM configuration of other parameters. 

2. Configure the interfaces in /etc/rc.config.d/netconf if necessary. 
Reboot after modifying pcitrconf and netconf. Alternatively, 
execute /sbin/rc2 .d/S315pcitr start after modifying pcitrconf 
and netconf, but before executing /sbin/rc2.d/S340net start or 
using ifconfig(IM). 

When configuring pcitrconf and netconf, please notethat white 
spaceis not permitted on either side of the equals symbol ("=") within 
the configuration files. 
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Token Ring Device Files (obsolete) 

Prior to 10.30, device files were used to identify theToken Ring driver 
and card. I nformation about device files is included here for those 
systems that may still beusingolder versions of HP-UX. 

Each driver/card was associated with a device file. By convention, device 
files were kept in a directory called / dev, with each device file having a 
name and device number to uniquely identify the above characteristics. 
For each Token Ringcardthat is bound successfully to the I/O subsystem 
at boot-up, the system created device files by default: / dev/ lanX. The 
card instance number was concatenated to the device file names. 

Using Device Files 

Once a system is re-booted, logon and follow the steps below to verify the 
Token Ring device files. If the major numbers or minor numbers are not 
correct, delete the device file entries from your / dev directory and 
recreate them with the correct numbers using the insf(lM) command. 

1. Execute the Ianscan command. 

2. Obtain a listing of the LAN device files. 

Is -1 /dev/lan* 

3. Compare the lanscan output with the device file listing to verify that 
the major and minor numbers are correct. 

When looking at the device file listing, the fifth column is the major 
number. The sixth column isthe minor number, OxnnOOOO where nn 
is the byte for the card instance number. 

Series 800 Device Files Example 

This example is for a Series 800 Model F20. 

The lanscan command provides the following output. (The HP DLPI 
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Support field has been removed from this output.) 


Hardware 

Station 

Crd 

Hardware 

Net-Interface 

NM 

MAC 

Mjr 

Path 

Address 

In# 

State 

NameUnit 

State 

ID 

Type 

Num 

44.1 

0x080009266C3F 

0 

UP 

lanO 

UP 

4 

ETHER 

185 

48 

0xl0009090C8EE 

1 

UP 

lanl 

UP 

5 

802.5 

103 


To Create Device Files Manually 

For PCI Token Ring 

Device files do exist for PCI Token Ring, but are not to be 
used/modified/created by users. 

All Other Token Ring 

To create device files manually for a Token Ring device, runthemknod 
command. For example: 

/usr/sbin/mknod /dev/lanl c 103 0x010000. 

I n the example above: 

• The number 1 in 7 dev/ lanl" is the card instance number. 

• The letter c is for character device. 

• The 103 is the major number. 

• The Olin 0x010000 is the card instance number (Crd I n#in 
lanscan(lM) output): 1=01,2=02. 

• A detailed explanation of the mknod(lM) command is provided in the 
man page. 

TheToken Ring device file created by the example command should be as 
follows: 

crw-rw-rw- 1 root sys 103 OxOlOOOOJan 28 08:58 /dev/lanl 
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Contacting Your HP Representative 

If you have no service contract with H P, you may follow the procedure 
described below, but you will be billed accordingly for time and materials. 

If you have a service contract with H P, document the problem as a 
Service Request (SR) and forward it to your H P representative. I nclude 
the following information where applicable: 

• A characterization of the problem. Describe the events leading up to 
and including the problem. Attempt to describe the source and 
symptoms of the problem. 

Your characterization should include: HP-UX commands; 
communication subsystem commands; job streams; result codes and 
messages; and data that can reproduce the problem. You should also 
provide a network map with the host name, I P/I nternet address, and 
station address of each system connected with the H P system as 
shown in the Network Card Configuration Worksheet in Token Ring 
Quick I nstallation Guide 

I llustrate as clearly as possible the context of any message(s). 

Prepare copies of information displayed at the system console and 
user terminal. 

• Obtain the version, update, and fix information for all software. To 
check theToken Ring version number, execute: 

what/stand/vmunix I grepToken. 

To check the version of your kernel, execute uname-r. 

This allows H P to determine if the problem is already known, and if 
the correct software is installed at your site. 

• Prepare copies of the /etc/hosts, /etc/rc.config.d/netconf, and 
hptokenconf or /etc/rc. config. d/pcitrconf files. 

• For PCI Token Ring only execute /sbin/rc2 .d/s3i5pcitr start 
and record the output. 

• For HP 9000 EISA only: Run the show board command of the 
elsa_config utility on theToken Ring card and record the output. 

• Executethedmesg command and record messages about the status of 
theToken Ring card. 
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• Execute the lanscan(lM) command to display information about the 
hardware path, station address, card instance number, hardware 
state, network interfacestate, network management ID, MAC type, 
and device major number. 

• Execute the display command of the lanadmin diagnostic on the 
Token Ring interface and record the output. 

• Record the troubleshooting flowchart number and step number where 
you are unable to resolve the problem. 

• Record al I error messages and numbers that appear at the user 
terminal and the system console. 

• Save all network log files. Makesurethat ERROR and DISASTER log 
classes are enabled when log files are collected. 

Prepare the formatted output and a copy of the log file for your H P 
representative to further analyze. 

• Prepare a listing of the HP-UX I/O configuration you are using for 
your HP representative to further analyze. Usethe ioscan(lM) 
command with the-f option to help collect this information. 

• Try to determine the general area within the software where you 
think the problem exists. Refer to the appropriate reference manual 
and follow the guidelines on gathering information for that product. 

• Document your interim, or "workaround," solution. The cause of the 
problem can sometimes be found by comparing the circumstances in 
which it occurs with the circumstances in which it does not occur. 

• Create copies of any I nternet or Token Ring link trace files that were 
active when the problem occurred for your H P representative to 
further analyze. 

• I n the event of a system failure, a selective dump must betaken. For 
HP-UX 10.x, usethe HP-UX utility savecore(lM) to save a core dump. 
For HP-UX 11.x, usesavecrash(lM). Send the output to your HP 
representative. 
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Thischapter provides guidelines for troubleshooting Token Ring. It 
contains the following sections: 
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• Troubleshcxoting Overview. 

• Diagnostic Flowcharts. 
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Troubleshooting Overview 

Token Ring problems can be caused by problems in a variety of hardware 
and software components. The problem impacting your system may 
originate in another part of the Token Ring network. 

As with any troubleshooting, a systematic approach is helpful. The 
following flowcharts providea logical sequenceof steps to follow when 
troubleshooting Token Ring. Using the diagnostic flowcharts provided in 
this chapter, identify whether the problem is with Token Ring or any of 
the connections to theTAU, or whether it is in some other part of the 
Token Ring network, verify your assumptions and, if it is limited to 
Token Ring software and hardware, correct the problem. 

If you cannot solve the problem on your own, contact your H P 
representative. Use the guidelines at the end of this chapter to help you 
effectively communicate what is wrong. 


NOTE Toquickly isolate and diagnoseToken Ring problems, follow the steps in 

the troubleshooting flowcharts in sequence, beginning with flowchart 1, 
and stay with the flowcharts until the problems are resolved. 
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Table 4-1 


Diagnostic Flowcharts 

Below is a summary of the types of network tests in the diagnostic 
flowcharts. To diagnose your problem, first check the connections and 
configuration on your system (flowcharts 1 through 4). If this does not 
solve your problem, use flowcharts 5, 6, 7, 8, and 9totestA/erify 
connectivity with a remote system. 

List of Flowcharts 


Flowchart 

Description 

1 

Token Ring Connections Test 

2, 2A, 3, 3A, 4 

Configuration Test 

5, 6 

Network Level Loopback Test 

7 

Transport Level Loopback Test (using 

ARPA) 

8 

Link Level Loopback Test 

9 

Bridge/Gateway Loopback Test 


Token Ring Connections Test: Checks that all the hardware 
connections between your system and theToken Ring network are 
connected and operational. 

Configuration Test: Verifies the configuration of the network interface 
on a host using the lanscan(lM), ioscan(lM), lanadmin(lM), and 
ifconfig(lM) commands. 

Network Level Loopback Test: Checks round trip communication 
between Network Layers on the source and target hosts using the 
ping(lM) command. 

Transport Level Loopback Test: Checks round trip communication 
between Transport Layers on the source and target hosts using ARPA 
services tel net and ftp commands. 

LinkLevel Loopback Test: Checks round trip communication between 
Link Levelson the source and target hosts using thelinkloop(lM) 
diagnostic. 
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Bridge/Gateway Loopback Test: Checks general network connections 
through a gateway. 
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Flowchart 1: Token Ring Connections Test 


Flowchart 1 
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Flowchart 1 Procedures 

A. Isyour system an HP 9000 HP-PB? Follow theflowchart path that 
corresponds to your system. 

B. Check self-test LED. If card operation is normal, the LED will turn 
on briefly during power up and then turn off. If the LED never comes 
on or stays on after a normal boot-up process, there is a card problem. 
If the LED is blinking, the ring speed may have been incorrectly 
configured or there may be a network error external to the card. Refer 
to the HP-PB Token Ring Network Adapter manual for moredetailed 
information. 

C. Verify lobe cable solidly connected. Without powering down the 
system, make sure the connector on your cable is sol idly connected to 
the card. If the connector has become disconnected, plug it in and 
continue. 

D. Verify physical connection toTAU or Switch. Make sure that 
your Token Ring cable is fully connected totheTAU or Switch and 
that the TAD or Switch state is UP. 

E. Verify Token Ring network is UP (other than your system). 

Make sure that the status of the Token Ring network is UP by 
checki ng the status of some of the other systems on the network, i .e. 
ask your co-workers if their systems are operational. 

F. Problem solved? I f so, stop. I f not, conti nue to G. 

G. Isyour system an HP 9000 HP-PB? Go to the flowchart 
corresponding to your system. For Series 800 H P-PB systems, 
conti nue to flowchart 2. Otherwise, conti nue to flowchart 2A. 
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Flowchart 2: Configuration Test (Series 8(X) HP-PB) 


Figure 4^2 


Flowchart 2 
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.O 

O 



78 


Chapter 4 







Troubleshooting Token Ring 

Diagnostic Fiowcharts 


Flowchart 2 Procedures 


NOTE Before prcxieeding to flowcharts 2 thrcxjgh 4, the Configuration Test 

flowcharts, be sure that your connectors to the card, wall plug, and 
TAU/Switch are fully connected. 


A. Execute lanscan. Execute lanscan to display information about 
Token Ring cards that are successfully bound to the system. For 
example, to check the cards on HP-UX, enter: lanscan. 

B. Is your Token Ring interface displayed and correct? lanscan is 
successful if the output shows information about every networking 
card in the hardware backplane whether the card state is UP or 
DOWN. The H ardware Path of one of the entries should correspond to 
your Token Ring card. Token Ring cards are identified by the MAC 
type 802.5. 

C. Run ioscan -f. ioscan -f will scan the system hardwareand list the 
results. LAN output similar to the foil owing will be displayed: 

Class I H/W Path Driver S/W State H/W Type Description 


Ian 1 16 token! CLAIMED INTERFACE HP J2166A - 802.5 Token Ring LAN 

The hardware path is four times the module number of the location 
where the card is installed. 

D. Is driver in kernel? If the driver has not been generated into the 
kernel, ioscan output will be: 

Class I H/W Path Driver S/W State H/W Type Description 


UNKNOWN 1 16 UNCLAIMED UNKNOWN HP J2166A - 802.5 Token Ring LAN 

E. Is device card displayed? If the device card is broken, no entry for 
the hardware path in which the card is inserted will be displayed. 

F. Build new kernel with driver. See "Creating a New Kernel" in the 
I nstalling and Administering LAN/ 9000 Software manual for 
instructions on how to create a new kernel. Refer to "Manual 

I nstallation and Configuration" in Chapter 3 of this manual for Token 
Ring-specific information. 
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G. Check hardware. Verify that the network card is seated correctly 
and that it is operational. 

H . Problem fixed? I f so, stop. I f not, start agai n with flowchart 2. After 
two iterations, if the problem still exists, call your HP representative. 
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Figure 4-3 
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Flowchart 2A: Configuration Test (non HP-PB) 

Figure 4^4 Flowchart 2A 


@ 



82 


Chapter 4 









Troubleshooting Token Ring 

Diagnostic Fiowcharts 


Flowchart 2A Procedures 

A. Execute lanscan. Execute lanscan to display information about 
Token Ring cards that are successfully bound to the system. For 
example, to check the cards on HP-UX, enter: lanscan. 

B. Is your Token Ring interface displayed and correct? lanscan is 
successful if the output shows information about every networking 
card in the hardware backplane whether the card state is UP or 
DOWN. The H ardware Path of one of the entries should correspond to 
your Token Ring card. Token Ring cards are identified by the MAC 
type 802.5. 

C. Isyour system a Model 712, HP 9000 EISA, or PCI? Follow the 
flowchart correspond! ng to your system. 

D. Run ioscan -f. ioscan -f will scan the system hardware and list the 
results. LAN output similar to the foil owing will be displayed: 


Class 

I 

H/W Path 

Driver 

S/W State 

H/W Type 

Description 

Ian 

0 

2/0/2 

lan2 

CLAIMED 

INTERFACE 

Built-in LAN 

Ian 

1 

5/0/7 

tokens 

CLAIMED 

INTERFACE 



E. Is driver in kernel? If the driver has not been generated into the 
kernel, ioscan output will be: 

Class I H/W Path Driver S/W State H/W Type Description 


unknown 1 5/0/7 ? UNCLAIMED INTERFACE 

The hardware path is 5/0/7 for the Token Ring card above. 

F. Device displayed? If the device card is broken, no entry for the 
hardware path in which the card is inserted will be displayed. 

G. Verify or edit /stand/system, rebuild kernel, and reboot. Verify 
or edit / stand/ system contai ns the tokens or pdtr keyword. I f not, see 
"Creating a New Kernel" in the I nstalling and Administering 
LAN/9000 Software manual for instructions on how to edit 

/ stand/ system to create a new kernel. Refer to Chapter 3, 'Token 
Ring Resources," in this manual for Token Ring-specific information. 

H . Check hardware. Verify that the network card is seated correctly 
and that it is operational. Refer to the hardware manual to verify 
hardware/card operation. 
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I . Problem fixed? If so, stop. If not, start again with flowchart 2A. If 
the problem still exists after two iterations, you may not have set the 
Ring Speed of the card. I n that case, conti nue to flowchart 3. 

J . Run ioscan -f. ioscan will scan the system hardware and list the 
results. LAN output similar to the foil owing will be displayed: 

Class I H/W Path Driver S/W State H/W Type Description 


Ian 1 4/0/1 tokenl CLAIMED INTERFACE HP J2165A 802.5 Token Ring 

LAN 


K. Is driver in kernel? If the driver has not been generated into the 
kernel, ioscan output will be: 

Class I H/W Path Driver S/W State H/W Type Description 


unknown -1 4/0/1 UNCLAIMED UNKNOWN 

The last number of the hardware path is the slot number of the 
location where the card has been installed. 

L. eisa config file exists and contents configured correctly? 

Check that the El SA Token Ring file exists by running eisa_config. 
If the file is OK, goto H. If it is not, go to N. 

M . Verify or edit /stand/system and regen kernel. Verify or edit 

/ stand/ system contains the token and eisa keywords. If not, refer to 
Chapter 3, 'Token Ring Resources," in this manual or "Creating a 
New Kernel" in the I nstalling and Administering LAN/ 9000 
Software manual for instructions on how to edit / stand/ system to 
create a new kernel. 

N. Verify or edit eisa_config file contents. Run eisa_configand verify 
that the connector type (FI) and ring speed (F2) configurations are 
correct. Do not change the interrupt (F3) configuration. Refer to the 
eisa_config(lM) man page or "Configuration for (older) EISA Cards" 
in Chapter 2 for detailed information about this command. 

O. Reboot system. Reboot the system to activate the eisa_conf ig 
changes. 
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Figure 4-5 



Chapter 4 


85 




Troubleshooting Token Ring 

Diagnostic Fiowcharts 


Figure 4^6 


Flowchart 3: Configuration Test 

Flowchart 3 



Select NMID (earlier than 10.30) 
or PPA (10.30 and later) command 
and enter NMID or PPA 



Run SAM 
or 

manually 
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- Reboot -h 


Change 

jumper 


Power on 
system 
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Flowchart 3 Procedures 

A. Execute lanadmin. Access the lanadmin(lM) program by entering: 

lanadmin. 

For a complete description of the lanadmin command, refer to the 
lanadmin(lM) on-line man page. 

B. Select LAN from Menu. Select Ian from the menu to enter LAN 
I nterface Diagnostic. 

C. For HP-UX versions earlier than 10.30, select the NMID 
command and enter the Token Ring NMID. Select the NMID 
command to display the current Network Management ID. Then 
enter the Network Management ID of theToken Ring device file such 
as 5. You can usethe lanscan command to find the NMID for your 
Token Ring. The device represented by the NMID that you enter 
becomes the current device to be tested. I f you receive an error, look 
at the UNIX error code. 

For H P-UX versions 10.30 or later, select thePPA command and enter 
theToken Ring PPA. 

D. Select display command. A display of theToken Ring card status 
and statistics will appear on the screen. TheToken Ring display 
shows a link type of iso8825-tokenRing (9). 

E. Op. Status = UP? If the card operation status is UP, continue to step 
G. If thecard is not UP, continue to step F. NOTE: If speed is incorrect 
for PCI Token Ring, operation status may be down. 

F. Resolve error condition. If the error code is Errno=(6,22,16), the 
NMID used by lanadmin does not correspond to an active LAN card. 
Using the NMID command in lanadmin, enter a valid NMI D and 
start again from step C. 

If the operation status=DOWN, the LAN card is currently 
inoperative. Reset thecard, usingthe reset command in lanadmin, to 
re-execute the LAN card self-test. If the test is successful, start again 
with this flowchart to display LAN card statistics. 

Another possibility is a bad cable. Check cable(s). 

G. Is the card link speed correct? Check the Speed field in the 
lanadmin status display to verify that the speed matches the speed of 
theToken Ring network. Refer to Appendix A for definitions of the 
lanadmin status fields. 
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H. Is your system a M712, HP 9000 EISA, S800 HP-PB, or PCI? 

Follow the flowchart corresponding to your system. 

I . Run eisa_config. Follow the instructions in "Configuration for 
(older) EISA Cards" in Chapter 2 to set the card link speed. 

J . Reboot. Execute reboot at the H P-UX prompt to activate the new 
configuration. 

K. Reboot -h. Execute shutdown -h at the HP-UX prompt to shut down 
your system. 

L. Change jumper. After you have shut down and powered off your 
system, follow the instructions in the H P-PB Token Ring Network 
Adapter Installation and Service Manual for setting the Data Rate 
Selection] umper. 

M . Power on system. 

N. Isthere a Token Ring status message? Check the error statistics 
and ring functional status in the Ianadmin status display. Refer to 
Appendix A for interpretation. 

O. Review status fields in Appendix A and correct problem. Look 
up the message and take the appropriate action to correct the 
problem. 

For PCI Token Ring, check the NetTL logs. 

P. Run SAM. Use SAM to set the link speed, following the steps below: 

• Doubleclick Networking and Communications at the SAM main 
window. 

• Doubleclick Network I nterfaceCards at the Networking and 
Communications window. 

• After the Network I nterface Cards window is displayed, highlight 
the Token Ring card and select Configure from the "Actions" 
menu. 

• Set the ring speed fields to the speed of your network (4 or 16 
M bps). I f connected to a 100 M b/s switch port and autosense is 
enabled, A5783A will operate at 100 Mb/s. 

• Exit SAM. 

• Wait a minute or two for the configuration change to take effect. 
For PCI Token Ring, SAM or manual configuration may be used. 
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Q. Problem fixed? If so, stop. If not, start again with flowchart 2A. 
After two iterations, if the problem still exists, call your HP 
representative. 
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Flowchart 3A: Configuration Test 

Flowchart 3A 
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Flowchart 3A Procedures 

A. Reset card. Use the reset command in lanadmin to reset the card. 
This re-executes the LAN card self-test. 

B. Reset successful? If the self-test was successful, the problem may 
be that you are not connected totheToken Ring network. 

C. Check Token entity logs. Use the netfmt -v -f 

/ var/ adm/ ndttl.LOGOO command to check the Token entity logs 
created at the ti me of the error. Refer to "Loggi ng M essages" i n 
Chapter 3 or the ndtfmt(lM) on-line man page for more information. 

For PCI Token Ring, the entity is pcitr. 

D. Check causes and actions. Refer to the description of the displayed 
log messages for proper actions. 

E . Problem solved? I f so, stop. I f not, go to flowchart 4. 

F. Problem fixed? I f so, stop. I f not, go to flowchart 4. 
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Figure 4^8 
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Flowchart 4: Configuration Test 

Flowchart 4 
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Flowchart 4 Procedures 

A. Execute ifconfig <3nterface><dP address>up. Execute ifconfig 
on the interface you want to test to be sure that the interface is 
enabled. For example, to check Token Ring interface Ian 1, enter: 

ifconfig lanl 192.6.1.17 up 

For more examples of the ifconfig command, refer to the ifconfig(lM) 
on-line man page. 

B. Execute ifconfig <jnterface>. Execute ifconfig again on the 
interface you want to test to check the flag setting is up. For example, 
to check Token Ring interface lanl, enter: 

ifconfig lanl 

C. ifconfig successful? ifconfig is successful if the output shows the 
correct I nternet Address and the flags: <UP, BROADCAST, 
NOTRAILERS, RUNNINO. 

For PCI Token Ring, the flags are: <UP, BROADCAST, RUNNING, 
MULTI CAST >. 

Note: Make sure the UP flag is displayed. Running is always 
displayed in ifconfig(lM). It indicates only that there is OS support 
for the interface. 

D. Any error message returned? If ifconfig is not successful, check 
whether an error message appears. 

E . Problem fixed? I f so, stop. I f not, go to K. 

F. ifconfig par ms in /etc/rc.config.d/netconf? Check that the Token 
Ring parameters for ifconfig(lM) are in the / etc/ rcconfigd/ ndtconf 
file for your Token Ring network interface. Refer to the I nstalling and 
Administering LAN/ 9000 Software manual for information on 
netconf. Refer to Chapter 3, 'Token Ring Resources," in this manual 
for a Token Ring example of this command. 

G. Add ifconfig parms to /etc/rc.config.d/netconf file. Add the 

ifconfig command to/ etc/ rcconfigd/ netconf. For more information, 
refer to the instructions in the netconf file under I nternet 
Configuration Parameters. 

H . Problem resolved? I f so, stop. I f not, recheck your connections to 
the wall plug and TAU. If the problem is still unresolved, goto 
flowchart 5. 
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I . Msg: No such interface name? The network interface name passed 
to ifconfig(lM) does not exist on the system. 

J . Find correct interface name. Check spelling and names of the 
network interfaces on the system using the lanscan(lM) command. 
Using the correct interface name, start again with flowchart 4. 

K. Correct ifconfig flag settings. If ifconfig returns an incorrect flag 
setting, re-execute the command with the proper setting. For more 
information, refer to the ifconfig(lM) on-line man page. Start again 
with flowchart 4, as necessary. 
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Figure 4^9 
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Flowchart 5: Network Level Loopback Test 

Flowchart 5 
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Flowchart 5 Procedures 

A. Execute ping to remote host. Using ping(lM), send a message to 
the remote host to which you are having problems connecting. For 
example: 

ping bunny 

B. ping successful? A message is printed on stdout for each ping 
packet returned by the remote host. If packets are being returned, 
your system has network level connectivity to the remote host. 

You may find it useful to note what percentage of the total packets are 
lost, if any. Losing ten percent or more may indicate the network or 
remote host is extremely busy. You may also find it useful to note the 
round-trip transmission times. Periodically, high transmission times 
may indicate that the network or remote host is extremely busy. 
Consistently high transmission times may indicate the local host is 
extremely busy. If a message is not returned after executing ping, 
ping is not successful. DoCntrl C to stop the ping output. 

C. Command hangs? Use Cntrl C toexit from ping(lM). 

D. Network unreachable? If so, check the status of the local Token 
Ring interface first using lanscan(lM). 

E. Check the Internet address. Check the remote host I nternet 
address. 11 should have the same network number as the local 

I nternet address. To bring up the interface, issue ifconfig(lM), eg., 
ifconfig lanl 192.6.1.17 up. 

F. Unknown host? Error= Unknown host hostname (alias)? 

G. Correct BIND, YP or /etc/hosts configuration. Add the missing 
host name and start again with flowchart 5. 

H . No route to host? E rror= Sendto: N o route to host? I f so, go to 
flowchart 6. Otherwise, call your HP representative. 
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Flowchart 6: Network Level Loopback Test 


Flowchart 6 



Note: This time ping 
from remote host to 
iocai host. 


98 


Chapter 4 







Troubleshooting Token Ring 

Diagnostic Fiowcharts 


Flowchart 6 Procedures 

A. Remote host entry in ARP cache? Using arp, check that an entry 
exists for the remote host in your system's ARP cache. For example: 

arp spiff 

B. Remote host up? If there is no ARP cache entry for the remote host, 
first check that the remote host is up. If not, the remote host has not 
broadcast an ARP message, and that likely is why there is no entry in 
the ARP cache. 

C. Bring up remote host. H ave the node manager of the remote host 
bring that system up. 

D. E ntry complete? Perhaps there is an ARP cache entry, but it is 
wrong or not complete. 

E. Use arp to complete entry. Using arp, enter the correct Host Name 
and Station Address. For more information, refer to the arp(lM) 
on-line man page. 

F. ping local host. Using ping, do an internal loopback on your own 
system. I n other words, ping your own system. 

G. ping successful? If the internal loopback is successful, your system 
is operating properly to the Network Layer (OSI Layer 3). I n addition, 
you know an ARP cache entry for the remote host exists on your 
system. If this is true, the network interface or software on the 
remote host is suspect. Start again with flowchart 5, but this time 

pi ng from the remote host to your system. If the ping in Step F was 
not successful, go to flowchart 1 to check your hardware installation. 

H . Remote support arp? H ave the node manager of the remote host 
check whether the remote host supports arp(lM). If so, go to flowchart 
1 to check the hardware installation. If not, go to flowchart 5 and this 
time ping another remote host that supports arp(lM). 
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Flowchart 7: Transport Level Loopback Test (using 
ARPA) 

Figure 4^12 Flowchart? 
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Flowchart 7 Procedures 

A. Execute telnet to remote host. Try to establish a telnet connection 
to the remote host. 

B. Successful? If your telnd; attempt was successful, stop. The 
connection is ok through the Transport Layer (OSI Layer 4). 

C. Execute ftp to remote host. UnliketeInPt, ftp does not go through a 
pseudo termi nal driver (pty) on your system. This step tests to see if 
the pty is why telnet failed. 

D. Successful? If ftp is successful, you likely havea problem with a pty 
on your system. Contact your HP representative. 

E. TCP configured on local or remote host? Neither telnet or ftp will 
work if TCP is not configured on either side of the connection. Check 
the/etc/protocols file on both hoststo besureTCP is installed and 
configured. 

F. Network congested? If so, the system administrator should 
determine the cause of the congestion. First, determine if there is a 
problem with any one of the nodes; there may be a hardware problem 
causing the congestion. Bridges or switches may be added so that the 
number of nodes in each loop is reduced. This should reduce the 
congestion. 

If not, call HP support for help in resolving the problem. 

IfTCP is installed on both hosts, doa filetransfer to another remote 
host on the network. Use ndtstat to check for lost packets. 

G. ConfigureTCP. If necessary, configureTCP on either or both hosts. 

Check for the presence of i netd and a properly configured 
/ etc/ inetd.conf. 
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Flowchart 8: Link Level Loopback Test 

Figure 4^ 13 Flowcharts 
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Flowchart 8 Procedures 

A. Executelinkicxoptoadjacent remotehost. Enterthelink level address 
(station address) of the adjacent remote host in hexadecimal form 
(preceded by "Ox"). Executelanscan (IM)tofind the link level address 
(station address) on the remote host or obtain it from your network 
map. For more information on linkloop, refer to the linkloop(lM) 
on-line man page. 

B. linkloop successful? If so, stop. Network connectivity is okay 
through the Link Layer (OSI Layer 2). If not, note which error was 
returned and conti nue with this flowchart. 

C. Correct parameter. Correct the input parameter to Iinkloop(lM) 
according to the linkloop message. Refer tothe linkloop(lM) man 
page for more i nformation. 

D. Failed due to illegal or bad input parameters? If the message 
indicates a failure, goto C. If not, conti nue to E. 

E . Choose a different adjacent remote host; re-execute linkloop. 

Redo linkloop(lM) using a different remote host. 

F. Problem solved? I f so, stop. I f not, go to J. 

G. linkloop successful? If so, stop. Network connectivity is okay 
through the Link Layer (OSI Layer 2). If not, go to flowchart 5 to 
verify network level connectivity. The problem may be with the 
remote system. 

H. Check remote host's connectivity to Token Ring; re-execute 
linkloop. Contact the node manager of the remote host. Check that 
the host is configured correctly and that its network interface is up. 
Re-execute linkloop. If necessary, verify configuration tothe remote 
host. 

I. linkloop successful? If so, stop. Network connectivity is okay 
through the Link Layer (OSI Layer 2). If not, go to flowchart 1. 

J . Execute linkloop to local host. If not in lOOM b/s or FDX modes, 
execute the linkloop(lM) command specifying the local Token Ring 
station address. For example: 

linkloop -i NMID <station address> 

K. linkloop successful? If so, theToken Ring link is verified. If not, go 
to flowchart 1 to verify the hardware. 

L. Problem solved? If so, stop. If not, the problem may be with the 
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remote system. 

M . Troubleshoot remote. Execute Iinkloop to adjacent remote host. 
Enter the link level address (station address) of the adjacent remote 
host in hexadecimal form (preceded by "Ox"). Execute lanscan (IM) to 
find the link level address (station address) on the remote host or 
obtain it from your network map. For more information on I inkloop, 
refer to the linkloop(lM) on-line man page. 


NOTE Starting with B.10.20.01 and B.11.11.02, linkloop(lM) to itself, through a 

switch, will work even if the card is in full duplex mode. 
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Figure 4'14 
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Flowchart 9: Bridge/Gateway Loopback Test 

Figure 4^ 15 Flowcharts 
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Flowchart 9 Procedures 

A. Execute ping from known good host through gateway to known good 
remote host. This will test gateway connectivity to the remote 
network. 

B. Successful? If the executing ping returned successfully, the problem 
may exist in the routing table for the problem host. Go toC. 

C. Check route table on problem host and all hosts in between. 

Execute netstat -r to examine a route table. 

D. Examine gateway. If the gateway isan HP 9000, gotoG. If it is not, 
go to F. 

E . Correct route tables. E nsure that the proper I P/I nternet addresses 
are assigned in the Destination and Gateway fields. If you are using 
subnetting, make sure that the destination is what you expect: a 
network or a host. 

F. Other HP or other vendors, refer to networking 
documentation. Refer to the documentation that came with the 
gateway for additional diagnostics. 

G. If HP 9000, execute ifconfig on gateway host. Execute ifconfigfor 
al I network i nterfaces on the gateway. Go to H. 

H . Network interface up? If the output from ifconfig does not include 
the UP parameter, the network interface is down. Execute ndtstat-i to 
check the status of the network interfaces. An asterisk (*) indicates 
that the interface is down. If the network interface is down, goto 
flowchart 4 to bring it up. 

If the network interfaces are UP, start again with flowchart 2 if 5800 
H P-PB or 2A if H P 9000 EISA. Using flowchart 2 or 2A, test all 
network interfaces on the gateway. 


Chapter 4 


107 




Troubleshooting Token Ring 

Diagnostic Fiowcharts 


108 


Chapter 4 




Token Ring Interface Card 
Statistics 


Appendix A 


109 




Token Ring Interface Card Statistics 

lanadmin 


lanadmin 

This appendix contains descriptions of the IEEE 802.5 Token Ring Ml B 
statistics fields for Token Ring interface cards which aredisplayed on the 
screen with the display command in lanadmin LAN I nterfaceTest Mode. 
A description of each field follows the display. Here is an example 
collected from a 5800. 


LAN INTERFACE STATUS DISPLAY 
Thu, Nov 21,1991 11:16:22 


Network Management ID = 
Description = 
Type (value) = 
MTU Size 

Speed = 
Station Address = 
Administration Status (value) = 
Operation Status (value) = 
Last Change = 
Inbound Octets = 
Inbound Unicast Packets = 
Inbound Non-Unicast Packets = 
Inbound Discards = 
Inbound Errors = 
Inbound Unknown Protocols = 
Outbound Octets = 
Outbound Unicast Packets = 
Outbound Non-Unicast Packets = 
Outbound Discards = 
Outbound Errors = 
Outbound Queue Length = 
Specific = 

Token Ring-like Functional Group 


5 

lanl Hewlett-Packard LAN ... 
iso88025-tokenring(9) 

4170 

16000000 
0xl0009060c8ee 
up (1) 
up (1) 

5917 

1862255299 

18765 

7644729 

0 

0 

0 

1304687 

18721 

19 

0 

0 

0 

655369 


Index 

Commands 

Ring Status 

Ring State 

Ring Open Status 

Ring Speed 

Up Stream Node Address 
Active Monitor Participation 
Functional Address Mask 


= 5 
= 1 
= 0 
= 1 
= 11 
= 4 

= 0x000000000000 
= 1 

= OxcOOOOOOOOOOO 
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Token Ring-like Statistics Group 


Index = 5 
Line Errors = 0 
Burst Errors = 0 
AC Errors = 0 
Abort Transmission Errors = 0 
Internal Errors = 0 
Lost Frame Errors = 0 
Receive Congestions = 0 
Frame Copied Errors = 0 
Token Errors = 0 
Soft Errors = 0 
Hard Errors = 0 
Signal Loss = 0 
Transmit Beacons = 0 
Ring Recovery = 0 
Lobe Wire Faults = 0 
Remove Station = 0 
Single Station on Ring = 0 
Frequency Errors = 0 


NOTE The'Token Ring-like Functional Group" and'Token Ring-like Statistics 

Group" sections shown in the listing above are not implemented in PCI 
Token Ring. 
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Token Ring Interface Card Statistics 

IEEE 802.5 Token Ring MIB 


IEEE 802.5Token Ring MIB 

For more detailed information about the fields described below, refer to 
RFC 1156 and RFC 1231. 


Field Description 

Network Management ID 

A unique ID assigned by the system for the network 
management of each network interface. 

Description A textual string containing information about the 

i nterface. 

Type (value) The type of interface, distinguished according to the 
physical/link protocol(s ) immediately below the 
network layer in the protocol stack. It will have one of 
the foil owing values (for Token Ring, it is always 

iso88025-tok:enRing (9)): 


other (1) 

N one of the fol lowi ng 

regularl822 (2) 


hdhl822(3) 


ddn-x25(4) 


rfc877-x25(5) 


ethernet-csmacd(6) 


i so88023-csmacd(7) 


i so88024-token B us(8) 


i so88025-token R i ng(9) 


iso88026-man(10) 


starLan(ll) 


proteon-lOM bit(12) 
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proteon-80M bit(13) 


hyper channel (14) 


fddi(15) 


lapb(16) 


sdlc(17) 


dsl(18) 

T-1 

el (19) 

European equivalent of T-1 

basiclSDN(20) 


primarylSDN(21) 

Proprietary serial 

proPoi ntToPoi ntSeri al (22) 


ppp(23) 


softwa reL oopback(24) 


eon(25) 

CLNP over IP [11] 

ethernet-3Mbit(26) 


nsip(27) 

XNS over IP 

slip(28) 

generic SLIP 

ulta(29) 

ULTRA technologies 

ds3(30) 

T-3 

sip(31) 

SMDS 

frame-relay(32) 



MTU Size NIO and EISA Token Ring support up to 4500 MTU. 

The default is set at 4170 but may be changed using 
lanadmin to the desired value of 4500, or less. 


Appendix A 


PCI Token Ring MTU can go up to 18000 Bytes. 

Please refer tothe latest Release Notes for software 
patches that may be required to support particular 
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Token Ring Interface Card Statistics 

IEEE 802.5 Token Ring MIB 


configurations of this product. 

Speed An estimate of the current bandwidth of the interface 

in bits per second. For interfaces which do not vary in 
bandwidth or for those where no accurate estimates 
can be made, this object contains the nominal 
bandwidth. 

Station Address The interface address at the protocol layer immediately 
below the network layer in the protocol stack. For 
interfaces which do not have such an address, such as 
serial line, this object contains an octet string of zero 
length. 

Administration Status 

The desired stateof the interface. This parameter is set 
toup(i) and is not configurable 

Operation Status The current operational stateof the interface. It will 
have one of the fol lowi ng val ues. 


Interface Operational States 


up(l) 

Ready to pass packets 

down(2) 

Not operative (bad card or cable) 

testingO) 

I n test mode 


Last Change The value of SysUpTime at the time the interface 
entered its current operational state. If the current 
state was entered prior to the last reinitialization of the 
local network management subsystem, then this object 
contains a zero value. This is not implemented in PCI 
Token Ring. 

I nbound Octets The total number of octets received on the interface, 
i ncl udi ng frami ng characters. 

Inbound Unicast Packets 

The number of subnetwork-unicast packets delivered 
to a high-layer protocol. 

Inbound Non-Unicast Packets 

The number of non-unicast (subnetwork-broadcast or 
subnetwork-multicast) packets delivered to a 
higher-layer protocol. 
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Inbound Discards The number of inbound packets that were discarded 
even though no errors had been detected, to prevent 
their being delivered to a higher-layer protocol. One 
possible reason for discarding such a packet could be to 
free up buffer space. 

I nbound Errors The number of inbound packets that contained errors 
preventing them from being deliverable to a 
higher-layer protocol. 

Inbound Unknown Protocols 

The number of packets received via the interface which 
were discarded because of an unknown or unsupported 
protocol. 

Outbound Octets The total number of octets transmitted out of the 
interface, including framing characters. 

Outbound Unicast Packets 

The total number of packets that higher-level protocols 
requested be transmitted to a subnetwork-unicast 
address, including those that were discarded or not 
sent. 

Outbound Non-Unicast Packets 

The total number of packets that higher-level protocols 
requested be transmitted to a non-unicast (a 
subnetwork-broadcast or subnetwork-multicast) 
address, including those that were discarded or not 
sent. 

Outbound Discards 

The number of outbound packets that were discarded 
even though no errors had been detected to prevent 
their being transmitted. One possible reason for 
discarding such a packet could be to free up buffer 
space. 

Outbound Errors The number of outbound packets that could not be 
transmitted because of errors. 

Outbound Oueue Length 

The length of the output packet queue (in packets). 
This is not implemented in PCI Token Ring. 
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Token Ring-Like Functional Group 


NOTE This is not implemented in PCI Token Ring. 


Field Description 

I ndex The value of this object identifies the 802.5 interfacefor 

which this entry contains management information. 
The valueof this object for a particular interface has 
the same val ue as the N etwork M anagement ID object 
for the same interface. 

Commands When this entry is set to open(2), the station should go 
i nto the open state. The progress and success of the 
open is given by the values of Ring State and Ring 
Open Status. 

When this entry is set to reset(3), then the station 
should do a reset. On a reset, all MIB counters should 
retain their values, if possible. Other side effects are 
dependent on the hardware chip set. 

When this entry is set to close(4), the station should go 
i nto the stopped state by removi ng itself from the ri ng. 

Setting this object to a valueof no-op(l) has no effect. 
When read, this object always has a valueof no-op(l). 

Ring Status The current interface status. You can use this to 
diagnose fluctuating problems that can occur on a 
token ring, after a station has successfully been added 
to the ring. Before an open is completed, this object has 
the value for the 'no status' condition. The Ring State 
and Ring Open Status entries provide information 
when the station cannot even enter the ring. The 
object's value is a sum of values, one for each currently 
applicable condition. The following values are defined 
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Table A-3 


Table A-4 


for various conditions: 

Ring Status Conditions 


0 

No problems detected 

32 

Ring Recovery 

64 

Single Station 

256 

Remove Received 

512 

Reserved 

1024 

Auto-Removal Error 

2048 

Lobe Wire 

4096 

Transmit Beacon 

8192 

Soft Error 

16384 

Hard Error 

32768 

Signal Loss 

131072 

No status, Open not completed 


Ring State The current interface state with respect to entering or 
leaving the ring. 

Interface State 


1 

opened 

2 

closed 

3 

opening 

4 

closing 

5 

openFailure 

6 

ring Failure 


Ring Open Status The entry indicates the success, or the reason for 

fai I ure, of the station's most recent attempt to enter the 
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ring. 

TabI e A-5 Statu s of Stati on E ntry Attempt 


1 

noOpen 

2 

badParam 

3 

lobeFailed 

4 

signal loss 

5 

insertion Timeout 

6 

ringFailed 

7 

beaconing 

8 

duplicateMAC 

9 

requestFailed 

10 

removeFailed 

11 

open (last open 
successful) 


Ring Speed The bandwidth of the ring. 


NOTE This is currently implemented incorrectly in PCI Token Ring. 


TableA-6 Ring Bandwidth 


1 

unknown 

2 

oneM egabit 

3 

fourMegabit 

4 

sixteen Megabit 


Up Stream Node Address 

The MAC address of the up-stream neighbor station on 
the ring. Currently not supported. 
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NOTE This is implemented correctly in PCI Token Ring. 


Active Monitor Participation 

If this entry contains a value of true(l), then this 
i nterface wi 11 participate in the active monitor selection 
process. Ifthevalueisfalse(2), then it will not. Setting 
this object might not have an effect until the next time 
the interface is opened. 

Functional Address Mask 

The bit mask of all Token Ring functional addresses for 
which this i nterface wi 11 accept frames. 
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Token Ring-Like Statistics Group 


NOTE This is not implemented in PCI Token Ring. 


Field 

I ndex 


Line Errors 


Burst Errors 


AC Errors 


Description 

The value of this object identifies the 802.5 interface for 
which this entry contains management information. 
The valueof this object for a particular interface has 
the same val ue as the N etwork M anagement ID object 
for the same interface. 

This counter is incremented when a frame or token is 
copied or repeated by a station, the E bit is zero in the 
frame or token and one of the following conditions 
exists: 1) there is a non-data bit (j or K bit) between 
the SD and the E D of the frame or token, or 2) there is 
an PCS error in the frame. 

This counter is incremented when a station detects the 
absence of transitions for five half-bit timers (burst-five 
error). 

This counter is incremented when a station receives an 
AMP or SMP frame in which A is equal toC is equal to 
0, and then receives another SM P frame with A is 
equal toC is equal to 0 without first receiving an AMP 
frame. It denotes a station that cannot set the AC bits 
properly. 


Abort Transmission Errors 

This counter is incremented when a station transmits 
an abort delimiter while transmitting. 


I nternal Errors This counter is incremented when a station recognizes 
an internal error. 


Lost Frame Errors 

This counter is incremented when a station is 
transmitting and itsTRR timer expires. This condition 
denotes a condition where a transmitting station in 


120 


Appendix A 



Token Ring Interface Card Statistics 

Token Ring-Like Statistics Group 

strip mcxde does not receive the trailer of the frame 
before the TRR ti mer goes off. 

Receive Congestions 

This counter is incremented when a station recognizes 
a frame addressed to its specific address, but has no 
available buffer space indicating that the station is 
congested. 

FrameCopied Errors Thiscounter is incremented when a station 

recognizes a frame addressed to its specific address and 
detects that the FS field A bits are set to 1 indicating a 
possible line hit or duplicate address. 

Token Errors This counter is incremented when a station acting as 
the active monitor recognizes an error condition that 
needs a token transmitted. 

Soft Errors The number of Soft Errors that interface has detected. 

It directly corresponds to the number Report Error 
MAC frames that this interface has transmitted. Soft 
errors are those which are recoverable by the MAC 
layer protocols. 

Flard Errors The number of times this interface has detected an 
immediately recoverable fatal error. It denotes the 
number of times this interface is either transmitting or 
receiving beacon MAC frames. 

Signal Loss The number of times this interface has detected the 
loss of a signal condition from the ring. 

Transmit Beacons The number of times this interface has transmitted a 
beacon frame. 

Ring Recovery The number of Claim Token MAC frames received or 
transmitted after the interface has received a Ring 
Purge MAC frame. Thiscounter signifies the number of 
times the ring has been purged and is being recovered 
back into a normal operating state. 

Lobe Wire Faults The number of times the interface has detected an 
open or short circuit in the lobe data path. The card 
will be closed and the Ring State will signify this 
condition. Be sure to check the Token Ring cable 
connections. 
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Remove Station The number of times the interface has received a 

Remove Ring Station MAC frame request. When this 
frame is received the interface will enter the close state 
and Ring State will signify this condition. 

Single Station on Ring The number of times the interface has sensed 

that it is the only station on the ring. This will happen 
iftheinterfaceisthefirstoneupon a ring, or ifthereis 
a hardware problem. 

F requency E rrors The number of ti mes the i nterface has detected that 
the frequency of the incoming signal differs from the 
expected frequency by more than that specified by the 
IEEE 802.5 standard. 


122 


Appendix A 




Token Ring Network Map 


Appendix B 


123 



Token Ring Network Map 

Map Description 


Map Description 

This section contains information that will help you createa network 
map. 

An accurate network map is essential for administering a Token Ring 
network. Such a map should include: 

• Approximate dimensions of the building or room containing the 
Token Ring network. 

• Location of nodes and node connections. 

• Hostnameof each node. 

• I nternet Address, Station Address, and Alias of each node (in the case 
of gateways, each Token Ring card has its own I nternet Address, 
Station Address, and Alias). 

• Hardware Path of each Token Ring card. 

• Version number of the operating system installed on each node. 

If you are installing Token Ring/9000, usetheToken Ring Network Card 
Configuration Worksheet in the Quick Installation Guide togather 
configuration information. Figure B-1 shows an example network map. 
Table B-1 shows a sample network map worksheet that you can use to 
list information about systems on your network such as those shown on 
the map. 
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Table B-1 Network Map Worksheet 


Hostname 

Internet 

Address 

Alias 

1 nternet 
Address 

Station 

Address 

Hardware 

Path 

Operating 

System 

A 

A 

192.20.20.1 

100090 

09030D 

5/0/7 

9.03 

B 

B 

192.20.20.2 

0000F6 

080102 

4/1/0 

9.0 

C 

C 


100090 

090C856 

44 

10.0 

D 

D 

192.20.20.4 

0000F6 

070102 

4/1/0 

10.0 

E 

E 

192.20.20.5 

100090 

80D756 

44 

9.0 

F 

F-20 

192.20.20.6 

101090 

EISA slot 1 

DOS 


F-25 

192.20.25.1 

900841 

101090 

907000 

EISA slot 2 

DOS 

G 

G 

192.20.25.2 

101090 

900801 

EISA slot 1 

DOS 

H 

H-25 

192.20.25.3 

0000F6 

060543 

4/1/0 

10.0 


H-30 

192.20.30.109 

0000F6 

080082 

4/2/0 

10.0 
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Token Ring Hardware Path 


Following is a description of hardware paths used by the I/O subsystem 
to identify Token Ring cards and device files associated with the cards. 
Refer to these descriptions as necessary when completing Token Ring 
installation, administration, and diagnostic procedures. 
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Table C-1 


Hardware Path 

The I/O subsystem identifies each Token Ring card by its hardware path. 
The hardware path is assigned by the system according to the physical 
location (slot) of the card in the hardware backplane. Below are 
definitions of the hardware path on each system type. 

Hardware Path 


Series 800 HP-PB 

Model 712 

HP 9000Add-on 
EISA 

For Series 800 H P-PB 
systems, the hardware 
path is determined by 
multiplying the slot 
number by 4. 

For Model 712 
systems, the 
hardware path is 
composed of three 
parts: an I/O module 
identifier, a slot 
identifier, and a card 
functionality 
identifier. The 
module identifier for 
a Core I/O card is 
always 5, the slot 
number for a Core 

I/O card is always 0, 
and the 
functionality 
identifier is 7. 

For Series 700 
systems, the 
hardware path is 
composed of three 
parts: an I/O module 
identifier, a 0, and a 
slot identifier. For 
add-on E1SA cards, 
the module 1D is 4, 
the slot number is a 
val ue from 1 through 

4. 

For example: 48 
specifies the hardware 
path of the FI P-P B card 
in slot 12. 

For example: 5/0/7 
specifies the 
hardware path of 
the Model 712 card. 

For example: 4/0/3 
specifies the 
hardware path for an 
add-on El SA card in 
slot 3. 


Usethe lanscan(lM) command to display the hardware path of each 
Token Ring card that is bound successfully to the I/O subsystem when 
the system is booted-up. 
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Access Method: A technique for 
determining which node will be 
the next with the right totransmit 
over a shared medium. 

Adapter: Hardwarethat contains 
the input/output logic needed for a 
product to interact with a 
computer bus, such as the EISA 
bus. An adapter is also called a 
controller board or an I/O card. 

Alias Nameof the interface that 
corresponds to a given I nternet 
address on a system. Refer to the 
network map in Appendix B for 
example usage. 

ANSI: The American National 
Standards I nstitute, a non-profit 
organization, made up of various 
expert committees, that publishes 
standards for use by national 
industries. ANSI has adopted the 
IEEE standards for local area 
networks. 

Beaconing: A condition during 
which 802.5 MAC frames are 
transmitted on the token ring. 
This condition occurs when a 
hardware problem is detected on 
the ring. The station that detects 
the error beacons other stations 
on the ri ng to i nform them of the 
problem. 

Card Instance Number A 

number that uniquely identifies a 
device within a group. A class of 
devices is a logical grouping of 
similar devices. 


Configuration: Thearrangement 
of a computer system or network 
as defined by the nature, number, 
and the chief characteristics of its 
functional units. More specifically, 
the term configuration may refer 
to a hardware configuration or a 
software configuration. 

Device Files: Files kept in the 
/dev directory that identify the 
LAN driver, card, and data link 
protocol. Each device file has a 
name and device number to 
uniquely identify the above 
characteristics. 

DLPI: Data Link Provider 
I nterface. An industry-standard 
definition for message 
communications to 
STREAM S-based network 
interface drivers. 

EISA Extended Industry 
Standard Architecture: A 

computer bus that connects EI SA 
cards to the main system bus. 

EI SA backplane: The I /O card 
that contains the EISA bus, which 
connects EI SA adapters to the 
main system bus. 

Ethernet: A 10 Mbps LAN, 
developed by Digital Equipment 
Corporation, I ntel, and Xerox 
Corporation, upon which the 
IEEE 802.3 network is based. 

Hardware Path: An identifier 
assigned by the system accord! ng 
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to the physical location (slot) of the 
card in the hardware backplane. 
On Series 700 and Series 800 
systems, the I/O subsystem 
identifies each LAN card by its 
hardware path. 

Hostname N ame of system on the 
network. Refer to the network map 
in appendix B for example usage. 

IEEE: The I nstitute of E lectrical 
and Electronics Engineers. A 
national association, whose 
activities include publishing 
standards applicable to various 
electronic technologies. The IEEE 
technical committees are 
numbered and grouped by area. 
For example, the 800 committees 
study local area network 
technologies. The 802.3 committee 
produced the standard for a 
CSMA/CD local area network, 
which has been adopted by ANSI. 
The 802.5 committee produced the 
standard for a Token Ring local 
area network which has been 
adopted by ANSI. 

IEEE 802.3 network: A 

10-megabit-per-second LAN, 
described by the ANSI/I EEE 802.3 
Standard for Local Area Networks, 
which uses a CSMA/CD network 
access method. 

IEEE 802.5 network: A 16- or 

4-megabit-per-second LAN 802.5 
network which has a token passing 
network access method and a ring 
or star configuration. 


Internet Address: The network 
address of a computer node. This 
address identifies both which 
network the host is on and which 
host it is. Refer to the I nstal I i ng 
and Administering LAN/ 9000 
Software manual for detailed 
information about network 
addressi ng. 

IP Address: See I nternet 
Address. 

LAN: See Local Area Network. 

LED: Light Emitting Diode, a 
semiconductor chip that emits 
light when activated. LEDs are 
commonly used as visible 
indicators to inform users that 
various components in a computer 
system or other electronic device 
are functioning. 

Lobe Cable: Used 
interchangeably with adapter 
cable; lobe cables attach at one end 
to a token ring adapter in the 
system and at the other end to a 
wall jack or TAU. 

Local Area Network (LAN): A 

data communications system that 
allows a number of independent 
devices to communicate with each 
other. 

Local Network: The network to 
which a node is directly attached. 

Major Number: Unique value 
that identifies an individual 
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hardware device. 

MIB: Management 
Information Base. A virtual 
data base of managed objects 
contained within the SNMP 
agent. The Ml B is not a physically 
distinct database, but rather it is 
a concept that includes 
configuration and status values 
normally available on the agent 
system. MIB I includes objects 
dealing with IP internetworking 
routing variables. MIB II or 
link-specific MIB extensions, now 
an I nternet standard, add new 
objects to the MIB I groups and 
also adds two new groups. 

The new groups add media devices 
and network devices to the SNMP 
capabilities. 

Maximum Transmission Unit 
(MTU). Largest amount of data 
that can be transmitted through 
that interface. This value does not 
include the LLC or MAC headers. 

Network Architecture: Any 

point in a network where services 
are provided or communications 
channels are interconnected. A 
node could be a workstation or a 
server processor. 

Network I nterface: A 

communication path through 
which messages can be sent and 
received. A hardware network 
interface has a hardware device 
associated with it, such as a LAN 


or FDDI card. A software network 
i nterface does not i ncl ude a 
hardware device, for example the 
loopback interface. For every IP 
address instance, there must be 
one network interface configured. 

Network Management 
Identifier (NMID): A unique ID 
assigned by the system for the 
network management of each 
network interface. 

Node: Any point in a network 
where services are provided or 
communications channels are 
interconnected. A node could be a 
workstation or a server processor. 

Packet: A sequence of binary 
digits that is transmitted as a unit 
in a computer network. A packet 
usually contains control 
information plus data. 

Protocol: A specification for 
coding messages exchanged 
between two communications 
processes. 

Remote: Not directly connected 
or processed at another location. 

Ring Speed: For Token Ring it is 
user selectable and can be set to 
4000000 or 16000000 bits per 
second. 

Station: Short for workstation, 
computer, or terminal that 
provides computational services 
and is attached to a local area 
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network. Also called a node. 

Subnetwork: Small discrete 
physical networks connected via 
gateways which share the same 
network address space. Refer to 
the I nstalling and Administering 
LAN/ 9000 Software manual for 
detailed information about 
subnetworks and subnet 
addressi ng. 

Subnet mask: A 32-bit mask 
which, when AND'd with an 
internet address, determines a 
subnetwork address. When the 
internet address is AND'd with the 
subnet mask, the ones in the host 
portion of the subnet mask will 
"overwrite" the corresponding bits 
of the host portion of the internet 
address, resulting in the subnet 
address. Refer to the I nstal I i ng 
and Administering LAN/ 9000 
Software manual for detailed 
information about subnet masks. 

System Administrator: The 

person who oversees network 
maintenance/operation. 

Trunk Access Unit (TAU): A 

central hub is used to connect to a 
token ring network. 

Token: A small bit pattern that 
circulates around a network. 
Ownership of the token enables a 
node to transmit over the network 
medium. 


Token Ring An IEEE 802.5 
network. See IEEE. 

Topology: The physical and 
logical geometry governing 
placement of nodes in a computer 
network. Also, the layout of the 
transmission medium for a 
network. 
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M 

messages, 61 
more(lM), 43, 44 

N 

netfmt(lM), 57 
netstat(l), 57 
verifying installation, 45 
verifying remote systems, 43, 44 
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